Getting started
Core resources
Other

Check submission status

You can check the status of a submission using the submission status API endpoints. This allows you to track whether a user's submission has been verified, canceled, or is still in progress.

For detailed information about authentication requirements and API specifications, see the OpenAPI Specification.

Single submission

Request

curl -L $SEEK_PASS_URL/api/partner/v1/submissions/$SUBMISSION_ID/status.json \
-H "Authorization: Bearer $ACCESS_TOKEN"

Response codes


200 OK: Submission status foundExample response when submission is verified:
{
    "id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e",
    "status": "verified"
}
Example response when submission is canceled:
{
    "id": "b10a30c1-1109-417a-83d3-9d06185ddd0e",
    "status": "canceled"
}
Example response when submission is in progress:
{
    "id": "3e8f0108-6b86-4c96-b197-aeec85aff942",
    "status": "incomplete"
}

Multiple submissions

Request

Up to 30 submission statuses can be retrieved

curl -X POST -L $SEEK_PASS_URL/api/partner/v1/submissions/status.json \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-d '{"ids":["id_1","id_2"]}'

Response codes


200 OKExample response:
{
    "credentials": [
      { "id": "id_1", "status": "verified" },
      { "id": "id_2", "status": "incomplete" }
    ]
}