Send Signing Document
Send a PDF document to one or more recipients for electronic signing. Supports sequential, parallel, and individual signing modes.
Endpoint
POST /api/sendSigningDoc
https://sandbox-services-sign.mobileid.dj/api/sendSigningDoc
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer YOUR_SIGN_AUTH_TOKEN (from Get Auth Token) |
OReference | Yes | UUID identifying your organization |
WebMobileIDAuthorization | Yes | Static API key assigned to your organization |
Body (multipart/form-data)
Document Information
| Field | Type | Required | Description |
|---|---|---|---|
document_title | string | Yes | Title of the document |
subject | string | Yes | Subject or objective of the signing request |
sender_email_id | string | No | Sender's email address |
sender_nin | string | Yes | NNI of the sender |
sender_name | string | Yes | Full name of the sender |
document | file | Yes | PDF file to be signed |
Signing Configuration
| Field | Type | Required | Description |
|---|---|---|---|
signing_mode | string | Yes | sequential, parallel, or individual |
document_outcome_scope | string | Yes | all_required, majority, or any |
signdoc_validity | integer | Yes | Days the document is available for signing |
signeddoc_validity | integer | Yes | Days the signed document is accessible after signing |
Recipients
Recipients are specified within a single default group (signing_groups[0]). For multi-group workflows, see Send Signing Document — Group Mode.
| Field | Type | Description |
|---|---|---|
signing_groups[0][recipients][N][signer_type] | string | individual or org_rep |
signing_groups[0][recipients][N][name] | string | Full name of the recipient |
signing_groups[0][recipients][N][email] | string | Email address (optional) |
signing_groups[0][recipients][N][phone] | string | Phone number (optional) |
signing_groups[0][recipients][N][order] | integer | Signing order (for sequential mode) |
signing_groups[0][recipients][N][mcode_or_name] | string | Required if signer_type is org_rep |
Replace N with 0, 1, 2... for each additional recipient.
signing_mode values
| Value | Description |
|---|---|
sequential | Recipients sign one after another in order sequence |
parallel | All recipients sign simultaneously |
individual | Single recipient workflow |
document_outcome_scope values
| Value | Description |
|---|---|
all_required | All recipients must sign |
majority | More than half must sign |
any | At least one signature is sufficient |
Example Request
POST /api/sendSigningDoc HTTP/1.1
Host: sandbox-services-sign.mobileid.dj
Authorization: Bearer YOUR_SIGN_AUTH_TOKEN
OReference: YOUR_ORGANIZATION_REFERENCE_UUID
WebMobileIDAuthorization: YOUR_WEB_MOBILEID_AUTHORIZATION_KEY
Content-Type: multipart/form-data
document_title = Contract Q2 2024
subject = Please review and sign the attached contract
sender_nin = YOUR_SENDER_NIN
sender_name = YOUR_SENDER_NAME
signing_mode = sequential
document_outcome_scope = all_required
signdoc_validity = 20
signeddoc_validity = 10
signing_groups[0][recipients][0][signer_type] = individual
signing_groups[0][recipients][0][name] = RECIPIENT ONE
signing_groups[0][recipients][0][order] = 1
signing_groups[0][recipients][1][signer_type] = org_rep
signing_groups[0][recipients][1][mcode_or_name] = YOUR_ORG_MEMBER_CODE
signing_groups[0][recipients][1][name] = RECIPIENT TWO
signing_groups[0][recipients][1][order] = 2
document = <PDF file>
Response
{
"document_id": "doc-uuid-xxxx",
"status": "sent"
}