Check submission status

New integrations should target API version 2. Please check out the OpenAPI Specification V2.

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.

Statuses

Status	Description
`incomplete`	The submission is in progress. Candidate can still complete the credential submission.
`canceled`	The submission is no longer proceeding and no credential has been awarded.
`verified`	The submission is successfully completed and a credential has been awarded.

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

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/..." }
    ]
}

Bulk Status API (V2)

A bulk status API is available for querying the status of multiple Add to SEEK Pass credentials simultaneously. Up to 30 request IDs can be included in a single query.

Due to maximum query size restrictions, depending on the length of the IDs provided, you might receive a 403 Forbidden response if your query string is longer than 2048 bytes. If you reach this limit, please reduce the number of query IDs passed in your request and try again.

# GET /api/partner/v2/add/requests?credential_id[]=25055614-f707-47cc-b7ed-1724c04dcd05&credential_id[]=9a98ba28-cd63-43d4-9959-9c593700c7da
{
    "credentials": [
        {
            "credential_id": "9a98ba28-cd63-43d4-9959-9c593700c7da",
            "created_at": "2026-01-20T02:43:09.440220Z",
            "results": [
                {
                    "credential_type": "digital_identity",
                    "status": "incomplete"
                }
            ]
        },
        {
            "credential_id": "25055614-f707-47cc-b7ed-1724c04dcd05",
            "created_at": "2025-12-18T06:34:34.338171Z",
            "results": [
                {
                    "credential_type": "digital_identity",
                    "status": "verified",
                    "verified_at": "2025-12-18T07:26:01.571197Z",
                    "digital_identity": {
                        "full_name": "John Smith"
                    }
                }
            ]
        }
    ]
}

Previous: Redirect user

Next: Revoke request