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 (exposed under both parties and the deprecated signers field — same content)
• Applied tags
• Custom field values
• Document timestamps (created, updated, completed, archived)

GET /api/v1/documents/{id}

Get a document by ID

cURL

curl --request GET \
  --url https://app.sajn.se/api/v1/documents/{id} \
  --header 'authorization: <authorization>'

200

{
  "id": "<string>",
  "name": "<string>",
  "status": "<string>",
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>",
  "signers": [
    {
      "id": "<string>",
      "documentId": "<string>",
      "name": "<string>",
      "signedAt": "<string>",
      "email": "[e-mail]",
      "phone": "<string>",
      "companyName": "<string>",
      "companyRole": "<string>",
      "companyOrgNumber": "<string>",
      "externalId": "<string>",
      "companyId": "<string>",
      "ssn": "<string>",
      "country": "<string>",
      "signingOrder": 123
    }
  ],
  "parties": [
    {
      "id": "<string>",
      "documentId": "<string>",
      "name": "<string>",
      "signedAt": "<string>",
      "email": "[e-mail]",
      "phone": "<string>",
      "companyName": "<string>",
      "companyRole": "<string>",
      "companyOrgNumber": "<string>",
      "externalId": "<string>",
      "companyId": "<string>",
      "ssn": "<string>",
      "country": "<string>",
      "signingOrder": 123
    }
  ],
  "externalId": "<string>",
  "expiresAt": "<string>",
  "documentMeta": {
    "subject": "<string>",
    "message": "<string>",
    "forceReadFullDocument": true,
    "showChatToSigners": true,
    "value": "<string>",
    "redirectUrl": "<string>",
    "redirectEnabled": true
  },
  "completedAt": "<string>",
  "tags": [
    {
      "id": "<string>",
      "name": "<string>",
      "color": "<string>"
    }
  ],
  "customFields": [
    {
      "id": "<string>",
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "fields": [
    "<string>"
  ]
}

Headers

authorization · string · required

Bearer token for API authentication

Path Parameters

id · string · required

Response

200

application/json

200

id · string · required

Unique document identifier

name · string · required

Document name/title

status · string · required

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

createdAt · any · required

Date and time when the document was created

updatedAt · any · required

Date and time when the document was last updated

signers · object[] · required

[DEPRECATED — use parties instead, will be removed in API v2] Array of document signers. Same content as parties.

Show child attributes

parties · object[] · required

Array of document parties (signers and other participants).

Show child attributes

externalId · string | null

Your external reference ID for this document

expiresAt · string | null

Date and time when the document expires

documentMeta · object

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

Show child attributes

completedAt · string | null

Date and time when all signers completed signing

tags · object[]

Show child attributes

customFields · object[]

Show child attributes

fields · string[]