Get a party with signing URL
2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.Retrieve a specific party including their signing URL.
Security Note: This endpoint creates an audit log entry each time a signing URL is accessed. Use this endpoint when you need the signing URL to share with the party.
Response includes:
- Party details (name, email, phone, company info)
- Signing status (NOT_SIGNED, SIGNED, REJECTED)
- Read status (NOT_OPENED, OPENED, READ)
- Complete signing URL with token
AuthorizationBearer <token>Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
id*stringpartyId*string200
application/json- response
id*stringUnique signer identifier
documentId*stringDocument ID this signer belongs to
email?|Signer email address
^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$emailname*stringSigner full name
phone?|Signer phone number (for SMS notifications)
companyName?|Company name
companyRole?|Role/title within the company
companyOrgNumber?|Company organization number
externalId?|Your external reference ID for this signer
companyId?|Linked company ID
ssn?|National identity number supplied by the sender when creating the document. Optional — BankID works without it, falling back to a name check. This is input and is never overwritten with what the eID verified: read the verified identity from GET /api/v1/documents/{id}/signatures.
country?|ISO 3166-1 alpha-3 country code for the signer (e.g. SWE)
role*stringSigner role: SIGNER, ORGANIZER, or REVIEWER
"SIGNER""ORGANIZER""REVIEWER"signingOrder?|Order for sequential signing (null for parallel)
token*stringUnique signing token
signedAt*|Date and time when the signer signed (null if not signed)
date-timereadStatus*stringRead status: NOT_OPENED, OPENED, or READ
"NOT_OPENED""OPENED""READ"signingStatus*stringSigning status: NOT_SIGNED, SIGNED, or REJECTED
"NOT_SIGNED""SIGNED""REJECTED"deliveryMethod*|How documents are sent to this signer: EMAIL, SMS, or NONE
"EMAIL""SMS""NONE""IN_APP"requiredSignature*|Signature type required: DRAWING, BANKID, CLICK_TO_SIGN, etc.
"NONE""DRAWING""BANKID""MANUAL""CLICK_TO_SIGN""NO_BANKID_BIOMETRIC""NO_BANKID_HIGH""NO_QES""DK_MITID""DK_MITID_ERHVERV""FI_FTN""NL_IDIN"twoStepVerification*|Two-step verification: NONE, SMS_BEFORE_SIGNING, EMAIL_BEFORE_SIGNING, or BANKID_BEFORE_SIGNING
"NONE""PIN_BEFORE_SIGNING""SMS_BEFORE_SIGNING""EMAIL_BEFORE_SIGNING""BANKID_BEFORE_SIGNING""NO_BANKID_BIOMETRIC_BEFORE_SIGNING""NO_BANKID_HIGH_BEFORE_SIGNING""DK_MITID_BEFORE_SIGNING""DK_MITID_ERHVERV_BEFORE_SIGNING""FI_FTN_BEFORE_SIGNING""NL_IDIN_BEFORE_SIGNING"sendStatus*|Send status: NOT_SENT, SENT, DELIVERED, BOUNCED, or FAILED
"NOT_SENT""SENT""DELIVERED""BOUNCED""FAILED"signingUrl*stringComplete signing URL for this signer
identityVerified*booleanTrue when an eID verified this signer — either by signing with one or by passing an eID verification gate.
identityMismatch*booleanTrue when an eID completed, the identity did not match the intended signer, and the signature was still recorded — read GET /api/v1/documents/{id}/signatures to see what differed. Stays false when the workspace requires an SSN match to sign and the attempt was refused, because no signature exists; those attempts appear only in the document audit trail.
curl -X GET 'https://app.sajn.se/api/v1/documents/string/parties/string' \ -H 'authorization: string'{ "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, "token": "string", "signedAt": "2019-08-24T14:15:22Z", "readStatus": "NOT_OPENED", "signingStatus": "NOT_SIGNED", "deliveryMethod": "EMAIL", "requiredSignature": "NONE", "twoStepVerification": "NONE", "sendStatus": "NOT_SENT", "signingUrl": "string", "identityVerified": true, "identityMismatch": true}Was this page helpful?