Skip to Content
Documents

Get a document file

GET
/api/v1/documents/{id}/files/{type}

Gets one file of a document, ORIGINAL, SIGNED, or JOURNAL, with a pre-signed URL that works for 15 minutes.

A file that isn't ready yet, such as the signed copy of a pending document, returns 409 INVALID_STATE. To see which files are ready, call GET /api/v1/documents/{id}/files.

Authorization

headerAuthorizationBearer <token>

API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.

Path Parameters

id*string

Document ID

type*string

The file: the unsigned ORIGINAL, the SIGNED and sealed copy, or the JOURNAL (audit trail).

Value in"ORIGINAL""SIGNED""JOURNAL"

Header Parameters

Sajn-Version?string

API 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.

Value in"2026-09""2026-10"
Sajn-Workspace?string

ID 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.

Response Body

200

application/json
  1. response
type*string

ORIGINAL, SIGNED, or JOURNAL

Value in"ORIGINAL""SIGNED""JOURNAL"
url*string

Pre-signed URL to download the file

Formaturi
expiresAt*string

Date and time when url stops working, 15 minutes after the request

Formatdate-time
Example Request
curl -X GET 'https://app.sajn.se/api/v1/documents/cm4k2x9p10003abcd1234efgh/files/ORIGINAL'
Example Response
{  "type": "ORIGINAL",  "url": "https://files.sajn.se/files/anstallningsavtal-kai-lindqvist.pdf",  "expiresAt": "2026-10-28T22:00:00.000Z"}

Was this page helpful?