API referenceApprovals

List approval thresholds

GET
/api/b/v1/approval-policies

Authorization

OAuth2PasswordBearer
AuthorizationBearer <token>

In: header

Query Parameters

include_retired?Include Retired
Defaultfalse
admin_access_token?string|null

Response Body

application/json

application/json

curl -X GET "https://example.com/api/b/v1/approval-policies"
{  "policies": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "subject_type": "payout",      "min_amount_minor": 0,      "currency": "string",      "required_approvals": 0,      "levels": [        {          "position": 0,          "role": "finance",          "required_approvals": 0        }      ],      "is_active": true    }  ]}

Verify a webhook

Prove a delivery came from us, including while a secret is rotating.

Add an approval threshold POST

Add a threshold. It applies to movements raised after this call. Anything already waiting keeps the rule it was raised under - an approver who has already agreed should not find their approval silently no longer counted.