Skip to Content

Get a document by ID

You're viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.
GET
/api/v1/documents/{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 (exposed under both parties and the deprecated signers field — same content)
  • Applied tags
  • Custom field values
  • Document timestamps (created, updated, completed, archived)

Authorization

headerAuthorizationBearer <token>

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Path Parameters

id*string

Header Parameters

authorization*string

Bearer token for API authentication

Response Body

200

application/json
  1. response
id*string

Unique document identifier

externalId?|

Your external reference ID for this document

expiresAt?|

Date and time when the document expires

Formatdate-time
name*string

Document name/title

status*string

Document status: DRAFT, SENDING, PENDING, COMPLETED, EXPIRED, CANCELLED, or IMPORTED

documentMeta?|

Document metadata including subject, message, signing order, etc.

createdAt*string

Date and time when the document was created

Formatdate-time
updatedAt*string

Date and time when the document was last updated

Formatdate-time
completedAt?|

Date and time when all signers completed signing

Formatdate-time
signers*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.

Example Request
curl -X GET 'https://app.sajn.se/api/v1/documents/string' \  -H 'authorization: string'
Example Response
{  "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?