API REFERENCE / DOCUMENTS

Send document for signing

Sends signing invitations to all signees on the document.

POST/api/documents/{documentId}/send-for-signingAPI key

Request

Authentication

Live response

⌁

Your response will appear here.

Send a request to the selected environment.

Request example

cURL

curl -X POST 'https://sandbox-api.bink.fi/api/documents//send-for-signing' \
  -H 'Accept: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY'

Examples use a placeholder key. Replace it in your application.

Response reference

Signing scenario

For a document created with signingMethod=strong, each applicable delivery result includes signeeId and signingUrl. This example uses the sandbox app URL.

Example JSON

{
  "message": "Document sent for signing",
  "result": [
    {
      "email": "alex@example.com",
      "status": "sent",
      "data": null,
      "error": null,
      "signeeId": "9383ca59-9ce2-493f-b2de-527cf837c352",
      "signingUrl": "https://sandbox.bink.fi/preview/documents/cfc80de9-1e3f-4c72-b490-73381c1702da?signeeId=9383ca59-9ce2-493f-b2de-527cf837c352"
    }
  ],
  "reminderCooldownUntil": "2026-09-24T09:00:00.000Z",
  "credit": {
    "tenantId": "3e02f5b5-162a-4ff1-b343-03bbf032d4a1",
    "email": 0,
    "strong": 9
  }
}

Response schema

message stringrequired

result arrayrequired

Nested fields

Array of:

email string

status string

sentfailederrorskipped

data object | null

error object | null

signeeId string | null

Present only for strong signing. Identifier of the signee this signing URL belongs to.

signingUrl string | null

Present only for strong signing. Per-signee URL for reviewing and signing the document. Omitted for email/SES signing.

credit object | nullrequired

Nested fields

tenantId string

email number

strong number

reminderCooldownUntil string | nullrequired

INTEGRATION NOTE

This operation consumes signature credits. Inspect individual delivery results before retrying.

Learn more

Confirm production request

This will run Send document for signing against production and may consume credits, send invitations, or permanently delete data.

POST https://sandbox-api.bink.fi/api/documents//send-for-signing