Get a document by ID
2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.Retrieve detailed information about a specific document including all parties, tags, and custom field values.
The response includes:
- Document metadata (subject, message, signing order, etc.)
- All document parties with their status (exposed under both
partiesand the deprecatedsignersfield — same content) - Applied tags
- Custom field values
- Document timestamps (created, updated, completed, archived)
AuthorizationBearer <token>Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
id*string200
application/json- response
id*stringUnique document identifier
externalId?|Your external reference ID for this document
expiresAt?|Date and time when the document expires
date-timename*stringDocument name/title
status*stringDocument status: DRAFT, SENDING, PENDING, COMPLETED, EXPIRED, CANCELLED, or IMPORTED
documentMeta?|Document metadata including subject, message, signing order, etc.
createdAt*stringDate and time when the document was created
date-timeupdatedAt*stringDate and time when the document was last updated
date-timecompletedAt?|Date and time when all signers completed signing
date-timesigners*array<>[DEPRECATED — use parties instead, will be removed in API v2] Array of document signers. Same content as parties.
parties*array<>Array of document parties (signers and other participants).
tags?array<>customFields?array<>fields?array<>Content blocks in position order. See the field endpoints for the per-type shapes.
productTables*array<>Every product table on the document, resolved: each row carries the recipient's final selected state and quantity, and the totals count the selected rows only. Empty when the document has no product table.
curl -X GET 'https://app.sajn.se/api/v1/documents/string' \ -H 'authorization: string'{ "id": "string", "externalId": "string", "expiresAt": "2019-08-24T14:15:22Z", "name": "string", "status": "string", "documentMeta": { "subject": "string", "message": "string", "signingOrder": "PARALLEL", "forceReadFullDocument": true, "showChatToSigners": true, "preferredLanguage": "sv", "value": "string", "redirectUrl": "string", "redirectEnabled": true, "internalRecipients": [ "string" ], "signableAfterExpired": true, "sendPlainTextEmailOnly": true, "reminderIntervalDays": "string", "allowDelegation": true, "accessVerification": "NONE", "aiChatEnabled": true, "ssnDisplayMode": "FULL", "sameDeviceSigning": true, "documentCategoryId": "string" }, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "completedAt": "2019-08-24T14:15:22Z", "signers": [ { "id": "string", "documentId": "string", "email": "user@example.com", "name": "string", "phone": "string", "companyName": "string", "companyRole": "string", "companyOrgNumber": "string", "externalId": "string", "companyId": "string", "ssn": "string", "country": "string", "role": "SIGNER", "signingOrder": 0, "signedAt": "2019-08-24T14:15:22Z", "readStatus": "NOT_OPENED", "signingStatus": "NOT_SIGNED", "deliveryMethod": "EMAIL", "requiredSignature": "NONE", "twoStepVerification": "NONE", "sendStatus": "NOT_SENT", "identityVerified": true, "identityMismatch": true } ], "parties": [ { "id": "string", "documentId": "string", "email": "user@example.com", "name": "string", "phone": "string", "companyName": "string", "companyRole": "string", "companyOrgNumber": "string", "externalId": "string", "companyId": "string", "ssn": "string", "country": "string", "role": "SIGNER", "signingOrder": 0, "signedAt": "2019-08-24T14:15:22Z", "readStatus": "NOT_OPENED", "signingStatus": "NOT_SIGNED", "deliveryMethod": "EMAIL", "requiredSignature": "NONE", "twoStepVerification": "NONE", "sendStatus": "NOT_SENT", "identityVerified": true, "identityMismatch": true } ], "tags": [ { "id": "string", "name": "string", "color": "string" } ], "customFields": [ { "id": "string", "name": "string", "type": "TEXT", "value": "string" } ], "fields": [ { "id": "string", "documentId": "string", "templateId": "string", "type": "TEXT", "position": 0, "fieldMeta": { "type": "TEXT", "content": "string", "locked": true, "sectionStyle": { "background": "none", "padding": "none", "bleed": true, "border": true }, "visibilityRule": { "customInputId": "string", "equals": "string", "mode": "SHOW_WHEN" }, "hidden": true }, "createdAt": null, "updatedAt": null } ], "productTables": [ { "fieldId": "string", "name": "string", "currency": "string", "language": "sv", "allowSelection": true, "selectionSignerId": "string", "selectionRequired": true, "sections": [ { "id": "string", "name": "string", "pickOne": true } ], "rows": [ { "id": "string", "sku": "string", "name": "string", "description": "string", "unit": "string", "price": 0, "moms": 0, "billing": "ONE_TIME", "discount": { "type": "PERCENT", "value": 0 }, "optional": true, "selected": true, "quantity": 0, "lineTotal": 0, "lineNet": 0, "lineMoms": 0, "sectionId": "string", "productType": "GOODS" } ], "totals": { "subtotal": 0, "discountAmount": 0, "momsAmount": 0, "total": 0, "rotDeduction": 0, "rutDeduction": 0, "payable": 0, "byBilling": { "property1": { "subtotal": 0, "momsAmount": 0, "total": 0 }, "property2": { "subtotal": 0, "momsAmount": 0, "total": 0 } } } } ]}Was this page helpful?