Skip to main content

GetVerification

GET 
/verifications/:id

Get a single verification by ID.

Returns the latest status, claim details and results for a verification you previously requested.

Vouchsafe will respond with:

  • the verification status and timestamps
  • the identity claim details (e.g. name, email, phone number)
  • the list of checks performed (e.g. liveness, photo ID, email verification) including outcomes and validations
  • results of any background checks (e.g. radar, online footprint analysis, aml sanctions)

Downloading files (artefacts)​

Some checks may include an artefacts array (for example: face scan or document images). For security reasons, the verification response only contains an artefact key — not the file itself.

To download an artefact, use:

  • GET /artefacts/{artefact_key}

This returns a time-limited pre-signed URL which can be used to download the file.

Erased verifications​

If the data subject has exercised their right to erasure, the verification's erased_at timestamp will be set, and erased_by records the operator who ran the erasure. The verification's status and timestamps are retained so you keep an audit trail, but all personal data (claim details, extracted document details, artefacts and enrichments) will be empty. Check erased_at to distinguish an erased verification from one that simply never collected that data.

This endpoint supports sandbox mode. See how sandbox mode works.

Request​

Responses​

OK