secuveriAPI docs
OpenAPIMarkdown

Read a verify an identity document check

GET/v1/documents/verify/{id}

For the organization and environment that started it, for 24 hours.

Send your API key in the x-api-key header.

Path parameters

  • idstringuuidrequired

Responses

  • 200The check.
    • check_idstringuuidrequired
    • productstring
    • environmentstring | null
    • statusstringrequired

      One ofPROCESSINGCOMPLETEDFAILED

    • sandboxboolean
    • created_atstringdate-time
    • completed_atstring | nulldate-time
    • reference_idstring
    • poll_urlstring
    • resultobject
      Show 16 child properties
      • check_idstringuuid
      • productstring
      • environmentstring | null
      • sandboxboolean
      • checked_atstringdate-time
      • reference_idstring
      • signed_resultstring

        The same answer as an ES256 JWS, verifiable with /.well-known/jwks.json.

      • decisionstring

        One ofPASSFAILREVIEW

      • outcomestring | null
      • reasonstring | null
      • documentobject
      • fieldsobject

        given_names, surname, document_number, date_of_birth, expiration_date, nationality, sex, issuing_country.

      • mrzobject | null

        The MRZ fields and their check-digit results.

      • fraudobject
      • authenticityobject | null
      • checks_not_runarray of string
    • errorobject
      Show 2 child properties
      • codestring
      • messagestring
  • 401Missing, unknown or expired API key.
  • 403The key lacks the product's scope.
  • 404No such check for this organization and environment.
curl https://api-verify.secuveri.com/v1/documents/verify/6f1c2e0a-8f43-4f7e-9a51-2b7c1d9e4a10 \
  -H "x-api-key: $SECUVERI_API_KEY"
Response · 200
{
  "check_id": "6f1c2e0a-8f43-4f7e-9a51-2b7c1d9e4a10",
  "environment": "<environment>",
  "status": "PROCESSING",
  "completed_at": "2026-10-23T09:12:44.120Z"
}