List pending AP approvals

GET /api/v1/ap-approval/pending

List bills currently suspended at an AP approval gate.

Operation ID: list_pending_approvals_api_v1_ap_approval_pending_get · View as markdown · OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Query

tier string: Filter to a specific tier: 'ops', 'advisor', or 'owner'.
mine boolean default: False: When true, only show approvals whose gate tier the caller is configured as an approver for.

Responses

200 Successful Response

Schema: PendingApprovalsResponse

items array · PendingApprovalItem PendingApprovalItem

Suspended approval rows, newest first (max 200).

7 fields

execution_id string required: Workflow execution UUID.
workflow_id string required: AP approval workflow UUID.
node_id string: Approval gate node id the run is waiting on.
tier string: Tier of the suspended gate ('ops', 'advisor', 'owner').
label string: Human-readable label of the suspended gate.
suspended_at string: ISO timestamp when execution was suspended.
bill PendingApprovalBill requiredPendingApprovalBill: Bill awaiting approval.

401 Unauthorized - Authentication required

403 Forbidden - Insufficient permissions

422 Validation Error

Schema: HTTPValidationError

detail array · ValidationError ValidationError

5 fields

loc array · string | integer required
msg string required
type string required
input object
ctx object

Code samples

GET /api/v1/ap-approval/pending

bash

curl -X GET 'https://api.ondayzero.com/api/v1/ap-approval/pending' \
  -H 'Authorization: Bearer dz_your_token' \
  -H 'x-business-id: YOUR_BUSINESS_ID'

javascript

const response = await fetch('https://api.ondayzero.com/api/v1/ap-approval/pending', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer dz_your_token',
    'x-business-id': 'YOUR_BUSINESS_ID',
  },
});
const data = await response.json();

python

import httpx

headers = {
    "Authorization": "Bearer dz_your_token",
    "x-business-id": "YOUR_BUSINESS_ID",
}

response = httpx.get("https://api.ondayzero.com/api/v1/ap-approval/pending", headers=headers)
data = response.json()