Check submission status

You can check the details of one or more submissions, such as the status and redirect URI, using the status API endpoints. This allows you to track whether a request has been verified, canceled, or is still in progress, and to fetch the redirect URI to direct the user back to SEEK Pass if they have dropped out of their submission.

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/$ID/status.json \
-H "Authorization: Bearer $ACCESS_TOKEN"

ID is the value supplied to the id field in the request body of the Partner Add endpoint (/api/partner/v1/add/$CREDENTIAL_TYPE.json):

Response codes

200 OK: Submission status foundExample response when submission is verified:

{
    "id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e",
    "status": "verified",
    "finalized_at": "2026-01-01T12:00:00Z",
    "redirect_uri": "https://app.seekpass-staging.com/partner/add/..."
}

Example response when submission is canceled (user cancels the credential):

{
    "id": "b10a30c1-1109-417a-83d3-9d06185ddd0e",
    "status": "canceled",
    "finalized_at": "2026-01-01T12:00:00Z",
    "redirect_uri": "https://app.seekpass-staging.com/partner/add/..."
}

Example response when submission is in progress (user hasn't completed the flow yet):

{
    "id": "3e8f0108-6b86-4c96-b197-aeec85aff942",
    "status": "incomplete",
    "finalized_at": null,
    "redirect_uri": "https://app.seekpass-staging.com/partner/add/..."
}

Multiple submissions

Request

Up to 30 submission statuses can be retrieved. If any of the IDs passed are not found, no error status is returned, but nothing will be present in the response data for that ID.

curl -X POST -L $SEEK_PASS_URL/api/partner/v1/submissions/status.json \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-d '{"ids":["f25c6425-eed4-4853-95bc-fb19aacd4e1e","b10a30c1-1109-417a-83d3-9d06185ddd0e"]}'

Response codes

200 OKExample response:

{
    "credentials": [
      { "id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e", "status": "verified", "finalized_at": "2026-01-01T12:00:00Z", "redirect_uri": "https://app.seekpass-staging.com/partner/add/..." },
      { "id": "b10a30c1-1109-417a-83d3-9d06185ddd0e", "status": "incomplete", "finalized_at": null, "redirect_uri": "https://app.seekpass-staging.com/partner/add/..." }
    ]
}

Previous: Redirect user

Next: Revoke request