Create Or Resume Submission

post/v1/submissions

Authentication

Send your tenant secret key as a Bearer token. Keep secret keys on your server; never ship them in browser or mobile code.

Request body

JSON · required

flow_id

string | null

No additional field description.

Example request

cURL

curl --request POST \
  --url 'https://api.fideralabs.com/v1/submissions' \
  --header 'Authorization: Bearer $FIDERA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "flow_id": "00000000-0000-0000-0000-000000000000"
}'

Responses

200Successful Response

applicant_id

stringrequired

No additional field description.

capture_state

SubmissionCaptureStaterequired

No additional field description.

created_at

stringrequired

No additional field description.

documents

SubmissionDocumentOut[]required

No additional field description.

entities

EvidenceEntityFragment[]required

No additional field description.

flow_id

string | nullrequired

No additional field description.

id

stringrequired

No additional field description.

last_activity_at

stringrequired

No additional field description.

processing_requested_at

string | nullrequired

No additional field description.

state

SubmissionStaterequired

No additional field description.

submitted_at

string | nullrequired

No additional field description.

updated_at

stringrequired

No additional field description.

version

integerrequired

No additional field description.

application/json

{
  "applicant_id": "00000000-0000-0000-0000-000000000000",
  "capture_state": {
    "assurance_level": "standard",
    "completed_steps": [
      "string"
    ],
    "current_step": "welcome",
    "selected_document_type": "string"
  },
  "created_at": "2026-07-29T12:00:00Z",
  "documents": [
    {
      "created_at": "2026-07-29T12:00:00Z",
      "doc_type": "string",
      "id": "00000000-0000-0000-0000-000000000000",
      "mime_type": {},
      "side": "string",
      "upload_status": "string"
    }
  ],
  "entities": [
    {
      "id": "string",
      "observed_at": {},
      "properties": {},
      "schema": "string"
    }
  ],
  "flow_id": "00000000-0000-0000-0000-000000000000",
  "id": "00000000-0000-0000-0000-000000000000",
  "last_activity_at": "2026-07-29T12:00:00Z",
  "processing_requested_at": "2026-07-29T12:00:00Z",
  "state": "string",
  "submitted_at": "2026-07-29T12:00:00Z",
  "updated_at": "2026-07-29T12:00:00Z"
}

422Validation Error

detail

ValidationError[]

No additional field description.

Operation ID

create_or_resume_submission_v1_submissions_post