Skip to content

Diia.Signature • Start

Request

Use this endpoint to start signing with Diia.Signature in the Diia app. Our system returns confirmation_url. Show it to the applicant, then call Diia.Signature • Get status to get the result.

Security
API-Key
Bodyapplication/jsonrequired
verification_idstringrequired

ID of the verification with documents to sign

Example:"9a8b7c6d5e4f30211203f4e5d6c7b8a90123"
{
  "verification_id": "9a8b7c6d5e4f30211203f4e5d6c7b8a90123"
}

Responses

OK

The request was processed. Check the status field.

  • need_sign — the link is ready. Show confirmation_url to the applicant.
  • forbidden — the verification has no documents to sign.
  • error — our system could not prepare the link. Try again later.
Bodyapplication/json
statusstring
Enum:"need_sign""forbidden""error"
Example:"need_sign"
dataobject
Response
{
  "status": "need_sign",
  "data": {
    "verification_id": "9a8b7c6d5e4f30211203f4e5d6c7b8a90123",
    "confirmation_url": "https://diia.example.com/deep-link/00000000"
  }
}