Get a bundle party with signing URL
Gets one party of a sent bundle, including their signing URL. The URL opens every document the party signs in the bundle. A DRAFT bundle has no signing URLs yet and returns 409 INVALID_STATE.
Security note: each call writes an audit entry on every document the party signs in the bundle.
Permission required: SEND_DOCUMENT on the workspace, and access to every document in the bundle.
Authorizations
API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
Headers
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.
2026-09, 2026-10 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
200
The party ID. To get the party's signing URL, pass it to GET /api/v1/bundles/{id}/parties/{partyId}.
The email address the party gets the invitation at. A bundle has one party per email address.
^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$SIGNER, ORGANIZER, REVIEWER The party's step for SEQUENTIAL signing.
-9007199254740991 <= x <= 9007199254740991How the party gets the invitation: ["EMAIL"], ["SMS"], ["EMAIL", "SMS"] for both, or ["IN_APP"] to sign in person on your device. [] sends nothing, so you share the signing URL yourself. Each channel needs the matching contact detail.
EMAIL, SMS, IN_APP How the party signs: DRAWING, SE_BANKID, CLICK_TO_SIGN, or another eID.
NONE, DRAWING, SE_BANKID, MANUAL, CLICK_TO_SIGN, NO_BANKID_BIOMETRIC, NO_BANKID_HIGH, NO_QES, DK_MITID, DK_MITID_ERHVERV, FI_FTN, NL_IDIN, ZEALID_QES, null Verification the party passes before signing: PIN, SMS, EMAIL, or an eID such as SE_BANKID. null means none. Call GET /api/v1/helpers/two-step-verifications for the methods your account can use.
PIN, SMS, EMAIL, SE_BANKID, NO_BANKID_BIOMETRIC, NO_BANKID_HIGH, DK_MITID, DK_MITID_ERHVERV, FI_FTN, NL_IDIN, null Verification this party passes before the documents open, in place of the bundle's openVerification. null uses the bundle's.
PIN, SMS, EMAIL, SE_BANKID, NO_BANKID_BIOMETRIC, NO_BANKID_HIGH, DK_MITID, DK_MITID_ERHVERV, FI_FTN, NL_IDIN, null SIGNED when the party has signed every one of their documents, REJECTED when they rejected any of them, otherwise PENDING. null for a party that doesn't sign, an ORGANIZER or REVIEWER.
PENDING, SIGNED, REJECTED, null The documents in the bundle the party is on.
The bundle ID.
The bundle page for this party. It opens every document they sign in the bundle.

