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

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

Copy
export PAYLOAD='{
  "id": "seek-pass-test-a9a4839f-53d9-4064-8b0b-1348113a33f8",
  "document_type": "open_cert",
  "credential_type": "education",
  "data": {
    "credential": {
      "full_name": "John Smith",
      "education_provider": "University of Melbourne",
      "course_name": "Bachelor of Commerce",
      "conferral_year": "2024",
    },
    "document": "<OPEN_CERTS>"
  }
}'

Response codes

{
    "id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e",
    "status": "verified",
    "finalized_at": "2026-01-01T12:00:00Z"
}

{
    "id": "b10a30c1-1109-417a-83d3-9d06185ddd0e",
    "status": "canceled",
    "finalized_at": "2026-01-01T12:00:00Z"
}

{
    "id": "3e8f0108-6b86-4c96-b197-aeec85aff942",
    "status": "incomplete",
    "finalized_at": null
}

Multiple submissions

Request

Up to 30 submission statuses can be retrieved

Copy
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

{
    "credentials": [
      { "id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e", "status": "verified", "finalized_at": "2026-01-01T12:00:00Z" },
      { "id": "b10a30c1-1109-417a-83d3-9d06185ddd0e", "status": "incomplete", "finalized_at": null }
    ]
}