POST /api/v1/reports/requests-by-destinations — Requests by Destinations Report
Returns a paginated report of signature requests broken down by individual destination (signer/reviewer/creator). Each row represents one destination's activity on a request, including the creator details, destination name, contact info, destination type and status, action/delivery dates, execution duration, and a direct signing URL. Supports filtering by request status, destination status, destination type, reference number, creator, search term, and date ranges (created, actioned, completed). Also returns aggregate totals across the result set.
Authentication
SadqAuthorize
Request Body
Content-Type: application/json
- createdFromDate (string, required)
- Start of the request creation date range
- createdToDate (string, required)
- End of the request creation date range
- destinationStatus (integer, optional)
- Filter by destination (signer) status (enum int)
- destinationType (integer, optional)
- Filter by destination type — signer, reviewer, creator, etc. (enum int)
- pageNumber (integer, required)
- Page index (1-based) for paginated results
- pageSize (integer, required)
- Number of rows per page
- requestStatus (string, required)
- Filter by overall request status (enum int)
- referenceNumber (string, optional)
- Filter by request reference number
- destinationSearch (string, optional)
- Search by destination name, email, or phone
- actionFromDate (string, optional)
- Start of the destination action date range
- actionToDate (string, optional)
- End of the destination action date range
- completedFromDate (string, optional)
- Start of the request completion date range
- completedToDate (string, optional)
- End of the request completion date range
{
"createdFromDate": "2025-06-06T12:59:47.005Z",
"createdToDate": "2026-06-09T12:59:47.005Z",
"destinationStatus": null,
"destinationType": null,
"pageNumber": 1,
"pageSize": 10,
"requestStatus": null
}Responses
HTTP 200 —
{
"data": {
"totalCount": 2,
"dataList": [
{
"requestId": "42ae7c04-9c0b-49ce-a4c1-af5363f7c096",
"referenceNumber": "Req-staging-2026-6393",
"createdDate": "2026-05-12T12:33:14.923",
"completedDate": "2026-05-12T09:35:06.983",
"requestStatus": 5,
"requestStatusName": "Completed",
"creatorName": "Nuha Taha",
"numberOfFiles": 1,
"filesNames": "Test_1.pdf",
"destinationEmail": "example@email.com",
"destinationTypeName": "Signer",
"destinationStatusName": "Signed",
"destinationName": "Sample User",
"numberOfSigners": 2,
"signingUrl": "http://example.com/sign/abc123"
}
],
"totals": {
"totalRequests": 1,
"totalNumberOfSigners": 2,
"totalSignedDestinations": 2,
"totalCompletedRequests": 1
}
},
"errorCode": 0,
"message": null
}