View document to sign
Retrieve the document a signer has been invited to sign, using the signer access code. Marks the document as viewed. Returns 409 while the document is still being prepared (retry with backoff).
Signers whose verification method is DigitalCertificate must have confirmed their data and accepted the terms before this returns the document; otherwise it is 400. Both are satisfied in one call to PUT /v1/documents/{documentId}/signers/confirm-data with has_accepted_terms: true, so send that before this endpoint — the has_accepted_terms query parameter here is too late to open the gate. PUT /v1/signers/accept-terms also works and is never gated.
Query parameters
Set true to record terms acceptance.
Response
The document with the signer's assignment
Example response
{
"status": 200,
"data": {
"resource": "document",
"id": "615601fab04c0a3147bb1246",
"account_id": "d199996981dbd199996981db",
"name": "document.pdf",
"status": "metadata_ready",
"artifacts": {
"original": "https://api.assinafy.com.br/v1/documents/doc1/download/original"
},
"signing_url": "https://api.assinafy.com.br/v1/sign/doc1",
"declined_by": {
"resource": "signer",
"id": "62d6ee35c7741ca4006b9e11",
"full_name": "John Signer",
"email": "john@email.com",
"whatsapp_phone_number": "+5548999990000"
},
"assignment": {
"resource": "assignment",
"id": "615606ef81d199996981dbce",
"sender_email": "sender@example.com",
"method": "virtual",
"signers": [
{
"resource": "signer",
"id": "62d6ee35c7741ca4006b9e11",
"full_name": "John Signer",
"email": "john@email.com",
"whatsapp_phone_number": "+5548999990000",
"verification_method": "Email",
"notification_methods": [
"Email"
],
"step": 1,
"notification_history": [
{
"event": "signature_request",
"status": "sent",
"sent_at": "2026-07-07T12:00:00Z"
}
]
}
],
"items": [
{
"page": {
"id": "615601faf166d6d1d8e7dc30",
"number": 1,
"height": 2100,
"width": 1275,
"download_url": "https://api.assinafy.com.br/v1/documents/doc1/pages/1a/download"
}
}
],
"signing_urls": [
{
"url": "https://api.assinafy.com.br/v1/sign/doc1?email=joe@example.com"
}
]
},
"pages": [
{
"id": "615601faf166d6d1d8e7dc30",
"number": 1,
"height": 2100,
"width": 1275,
"download_url": "https://api.assinafy.com.br/v1/documents/doc1/pages/1a/download"
}
],
"created_at": "2026-06-03T03:54:16Z",
"updated_at": "2026-06-03T03:54:16Z"
}
}Changes
No recorded changes to this endpoint across all 1 revision of this API.