Send Signing Document — Group Mode

Send a PDF document to multiple signing groups. Each group has its own signing mode, outcome scope, and recipients. Groups are processed in order.

Endpoint

POST /api/sendSigningDoc

Same endpoint as Send Signing Document — group mode is activated by setting signing_mode = group.

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
sender_email_id	string	No	Sender's email
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

Group Mode Configuration

Field	Value
signing_mode	Must be group
document_outcome_scope	Must be group_required
signdoc_validity	Days available for signing
signeddoc_validity	Days signed doc is accessible

Group Fields

For each group G (starting at 0):

Field	Type	Description
signing_groups[G][name]	string	Display name of the group
signing_groups[G][mode]	string	sequential or parallel
signing_groups[G][outcome_scope]	string	all_required, majority, or any
signing_groups[G][order]	integer	Processing order (groups run sequentially)

Recipient Fields

For each recipient N in group G:

Field	Type	Description
signing_groups[G][recipients][N][signer_type]	string	individual or org_rep
signing_groups[G][recipients][N][name]	string	Full name
signing_groups[G][recipients][N][email]	string	Email (optional)
signing_groups[G][recipients][N][phone]	string	Phone (optional)
signing_groups[G][recipients][N][order]	integer	Order within the group
signing_groups[G][recipients][N][mcode_or_name]	string	Required if signer_type is org_rep

Example: Two Groups

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 = Annual Report Sign-Off
subject = Please sign the annual report
sender_nin = YOUR_SENDER_NIN
sender_name = YOUR_SENDER_NAME
signing_mode = group
document_outcome_scope = group_required
signdoc_validity = 20
signeddoc_validity = 10

signing_groups[0][name] = HR Team
signing_groups[0][mode] = parallel
signing_groups[0][outcome_scope] = all_required
signing_groups[0][order] = 1
signing_groups[0][recipients][0][signer_type] = individual
signing_groups[0][recipients][0][name] = HR MEMBER 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] = HR MEMBER TWO
signing_groups[0][recipients][1][order] = 1

signing_groups[1][name] = Legal Team
signing_groups[1][mode] = sequential
signing_groups[1][outcome_scope] = any
signing_groups[1][order] = 2
signing_groups[1][recipients][0][signer_type] = individual
signing_groups[1][recipients][0][name] = LEGAL MEMBER ONE
signing_groups[1][recipients][0][order] = 1
signing_groups[1][recipients][1][signer_type] = org_rep
signing_groups[1][recipients][1][mcode_or_name] = YOUR_ORG_MEMBER_CODE
signing_groups[1][recipients][1][name] = LEGAL MEMBER TWO
signing_groups[1][recipients][1][order] = 2

document = <PDF file>

Notes

• Groups are processed in order sequence — Group 1 completes before Group 2 begins.
• document_outcome_scope = group_required means all groups must satisfy their outcome_scope.