Get a document by ID
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
- Applied tags
- Custom field values
- Product tables with their resolved totals
- Document timestamps (created, updated, completed, archived)
Content blocks: content is null unless you pass expand=content. To poll a document's status, leave it out. To read the content, pass expand=content or call GET /api/v1/documents/{id}/content.
AuthorizationBearer <token>API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
id*stringThe document ID.
expand?array<>Related data to include in the response, comma-separated or repeated. content adds the document's content blocks.
Sajn-Version?stringAPI version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
"2026-09""2026-10"Sajn-Workspace?stringID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.
200
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""PENDING_APPROVAL""PENDING""COMPLETED""EXPIRED""CANCELLED""REJECTED""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-timedeletedAt*|Date and time when the document moved to the trash, or null when it isn't in the trash
date-timetemplateId*|ID of the template the document was created from, or null
folderId*|ID of the folder that holds the document, or null at the top level
responsibleUserId*|ID of the workspace member responsible for the document
parties*array<>Array of document parties (signers and other participants).
tags*array<>customFields*array<>content*array<>|Content blocks in position order when you pass expand=content, and null otherwise. See the content 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.
approvalRequestId*|ID of the document's approval request, or null when it has none. To read it, call GET /api/v1/approval-requests/{id}.
bundleId*|ID of the bundle the document was sent in, or null. Every document in a bundle also fires its own events, so this is the key that groups them. To read the bundle, call GET /api/v1/bundles/{id}.
curl -X GET 'https://app.sajn.se/api/v1/documents/cm4k2x9p10003abcd1234efgh'{ "id": "cm4k2x9p10003abcd1234efgh", "externalId": "HR-2026-0142", "expiresAt": "2026-10-28T22:00:00.000Z", "name": "Anställningsavtal – Kai Lindqvist", "status": "COMPLETED", "documentMeta": { "subject": "Ditt anställningsavtal från Exempelbolaget AB", "message": "Hej Kai! Här är ditt anställningsavtal. Signera det med BankID senast den 28 oktober.", "signingMode": "PARALLEL", "forceReadFullDocument": false, "showChatToSigners": false, "language": "sv", "value": "540000", "redirectUrl": null, "redirectEnabled": true, "internalRecipients": [ "hr@example.com" ], "signableAfterExpired": false, "sendPlainTextEmailOnly": false, "reminderIntervalDays": 3, "allowDelegation": false, "openVerification": "PIN", "aiChatEnabled": false, "nationalIdDisplayMode": "FULL", "sameDeviceSigning": false, "documentCategoryId": "cm4k2x9p10017abcd1234efgh" }, "createdAt": "2026-09-28T09:12:00.000Z", "updatedAt": "2026-09-28T09:15:00.000Z", "completedAt": "2026-09-29T07:41:00.000Z", "deletedAt": null, "templateId": "cm4k2x9p10008abcd1234efgh", "folderId": "cm4k2x9p10011abcd1234efgh", "responsibleUserId": "cm4k2x9p10002abcd1234efgh", "parties": [ { "id": "cm4k2x9p10004abcd1234efgh", "documentId": "cm4k2x9p10003abcd1234efgh", "email": "kai@example.com", "name": "Kai Lindqvist", "phone": "+46701740605", "type": "INDIVIDUAL", "company": null, "externalId": "HR-2026-0142", "contactId": "cm4k2x9p10006abcd1234efgh", "nationalId": "191212121212", "country": "SE", "role": "SIGNER", "signingOrder": 1, "signedAt": "2026-09-29T07:41:00.000Z", "readStatus": "READ", "signingStatus": "SIGNED", "delivery": [ "EMAIL" ], "signatureMethod": "SE_BANKID", "signVerification": "PIN", "openVerification": "PIN", "sendStatus": "DELIVERED", "identityVerified": true, "identityMismatch": false, "createdAt": "2026-09-28T09:12:00.000Z" } ], "tags": [ { "id": "cm4k2x9p10010abcd1234efgh", "name": "Anställning", "color": "#16A34A" } ], "customFields": [ { "id": "cm4k2x9p10016abcd1234efgh", "name": "Startdatum", "type": "TEXT", "value": "2026-11-01" } ], "content": [ { "id": "cm4k2x9p10009abcd1234efgh", "documentId": "cm4k2x9p10003abcd1234efgh", "templateId": null, "type": "TEXT", "position": 0, "fieldMeta": { "type": "TEXT", "content": "<p>Anställningen gäller tills vidare från och med den 1 november 2026, med sex månaders provanställning.</p>" }, "createdAt": "2026-09-28T09:12:00.000Z", "updatedAt": "2026-09-28T09:12:00.000Z" } ], "productTables": [ { "fieldId": "cm4k2x9p10009abcd1234efgh", "name": "Anställningsavtal – Kai Lindqvist", "currency": "SEK", "language": "sv", "allowSelection": false, "selectionPartyId": "cm4k2x9p10004abcd1234efgh", "selectionRequired": false, "sections": [ { "id": "cm4k2x9p10037abcd1234efgh", "name": "Utbildningar", "pickOne": false } ], "rows": [ { "id": "cm4k2x9p10036abcd1234efgh", "sku": "UTB-INTRO", "name": "Introduktionsutbildning", "description": "Introduktionsutbildning.", "unit": "st", "price": 4500, "vat": 25, "billing": "ONE_TIME", "discount": { "type": "PERCENT", "value": 1 }, "optional": false, "selected": false, "quantity": 1, "lineTotal": 1, "lineNet": 1, "lineVat": 1, "sectionId": "cm4k2x9p10037abcd1234efgh", "productType": "GOODS" } ], "totals": { "subtotal": 4500, "discountAmount": 1, "vatAmount": 1125, "total": 1, "rotDeduction": 1, "rutDeduction": 1, "payable": 5625, "byBilling": { "ONE_TIME": { "subtotal": 4500, "vatAmount": 1125, "total": 1 }, "MONTHLY": { "subtotal": 4500, "vatAmount": 1125, "total": 1 }, "QUARTERLY": { "subtotal": 4500, "vatAmount": 1125, "total": 1 }, "YEARLY": { "subtotal": 4500, "vatAmount": 1125, "total": 1 } } } } ], "approvalRequestId": "cm4k2x9p10003abcd1234efgh", "bundleId": "cm4k2x9p10044abcd1234efgh"}Was this page helpful?