Approval

List internal approval requests for the organization

GET
/api/approval/internal/list

Returns paginated INTERNAL approval requests for the caller organization, sorted newest first, with userId / approvedBy / contactId / escalationTargets populated. Restricted to SUPERADMIN, ADMIN, and DEPARTMENT_HEAD roles. The status query supports comma-separated values for history views (e.g. approved,rejected,failed); defaults to pending.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

status?string
limit?integer
Range1 <= value <= 100
Default50
skip?integer
Range0 <= value
Default0

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/approval/internal/list"
{  "success": true,  "approvals": [    {      "_id": "64d2f9c5e8a1d4e001a0b1c2",      "approvalType": "internal",      "status": "pending",      "question": "Approve booking a Tuesday 2pm tour for Alex Nguyen?",      "deferredTool": "book_tour",      "createdAt": "2026-04-22T10:14:00.000Z"    }  ],  "total": 1,  "limit": 50,  "skip": 0}