Signing

Identity document verification status

Changed on

Current state of the signer's identity document verification. Backfills a pending decision from the provider. Uses the signer access code.

One live session per signer: can_start is true before a provider session exists, and again once that session is Expired -- the capture link lapsed before anything was submitted, so the signer may open a new one. Once a session is Pending, In Review, Approved, Declined or Abandoned it is false. A signer who reaches Declined or Abandoned cannot restart here; the account must start a whole new process (new document, new assignment).

In review: the signer continues -- views, confirms their data and signs -- while the account reviews the result. The document is certificated only after the account approves every signer under review; if it rejects one, the document is cancelled and every signer receives the cancellation notice.

Copy as Markdown Open in ChatGPT Open in Claude

get/v1/signers/identity-verification

Request

  • Base URL
    https://api.assinafy.com.br
  • URL
    https://api.assinafy.com.br/v1/signers/identity-verification
  • Auth
    API key in query parameter signer-access-code

Response

Verification state

statusinteger

HTTP status code, mirrored in the body.

messagestring

Human-readable message; empty on success.

Example response

{
  "status": 200,
  "data": {
    "status": "Pending",
    "url": "https://verify.assinafy.com.br/c/01a0ed77-2afe-7f4b-bca9-349edcf4bb99#t=token",
    "expires_at": "2026-10-07T21:18:47Z",
    "completed_at": "2026-08-10T20:32:00Z"
  }
}

Changes