Get started
Pagination and async jobs
List endpoints accept page parameters. Long-running imports and AI jobs return 202 — poll until they finish.
Pagination
The gateway forwards query strings unchanged. Common list parameters:
| Area | Query |
|---|---|
| Contacts | page, per_page, search |
| Workflows | page, search |
| Signed documents | page |
| EDM documents | page, folder_id, search |
| Audit events | from, to, page |
The pagination envelope (data, meta, links) is defined by each upstream. Read the fields you need and ignore the rest.
Async jobs
Some writes accept a file or a heavy analysis and return 202 with a job id. Poll the matching GET until the job completes.
- Contacts CSV import → POST /api/contacts/imports/csv then
GET /api/contacts/imports/{job_id} - AI analyze with
async=true→GET /api/ai/jobs/{job_id} - EDM export →
GET /api/edm/export/{job_id}
http
POST /api/contacts/imports/csv
Authorization: Bearer $DKBSIGN_TOKEN
→ 202 { "data": { "id": "job_123", "status": "queued" } }