Generate a signature request for a policy
Pass branchId: the documents offered are the unsigned ones on that branch, so omitting it looks at the base contract and fails with NO_UNIQUE_DOCUMENT_TYPE_READY_TO_BE_SIGNED and documentNumber: 0. Signing is a human action you then observe by polling — never by re-issuing this call, which creates a second request. On direct debit it is also refused with NO_VALID_PAYMENT_METHODS until a usable payment method exists.
Authorizations
Machine-to-machine clients use the OAuth 2.0 client credentials grant. Each tenant has its own authorization server: in the token URL below, replace tenant with your tenant identifier.
Headers
Your tenant identifier. Requests without it are rejected.
Path Parameters
the policy id
^policy(_test)?_[346789ABCDEFGHJKLMNPQRTUVWXYabcdefghijkmnpqrtwxyz]{21}$Query Parameters
Optional: the whenAt datetime
Optional: the branchId
^branch(_test)?_[346789ABCDEFGHJKLMNPQRTUVWXYabcdefghijkmnpqrtwxyz]{21}$Body
the delivery mode
EMAIL, URL Do we want to sign the documents needed for the policy to be signed? If yes, it signs all those documents at the same time.
if the signature request is an otp one or not
the phone number
Response
the signature requests

