Compose Finance
Withdrawals

Get withdrawal allowance

Returns the current allowance status for API withdrawals. Use this endpoint to check your available API allowance. The allowance determines whether withdrawals execute automatically (`PROCESSING`) or require manual approval (`PROPOSED`) from the dashboard. **Response Fields** - `enabled`: Whether API withdrawals are fully configured for your organization - `allowance.limit`: Total allowance amount per reset period (USDC) - `allowance.spent`: Amount already used this period (USDC) - `allowance.available`: Remaining amount you can withdraw automatically (USDC) - `allowance.resetPeriodMinutes`: How often the allowance resets (0 = one-time, no reset) - `allowance.nextResetAt`: When the allowance will reset (null if one-time)

GET
/api/v2/customers/withdrawal/allowance

Returns the current allowance status for API withdrawals.

Use this endpoint to check your available API allowance. The allowance determines whether withdrawals execute automatically (PROCESSING) or require manual approval (PROPOSED) from the dashboard.

Response Fields

  • enabled: Whether API withdrawals are fully configured for your organization
  • allowance.limit: Total allowance amount per reset period (USDC)
  • allowance.spent: Amount already used this period (USDC)
  • allowance.available: Remaining amount you can withdraw automatically (USDC)
  • allowance.resetPeriodMinutes: How often the allowance resets (0 = one-time, no reset)
  • allowance.nextResetAt: When the allowance will reset (null if one-time)

Authorization

bearerAuth
AuthorizationBearer <token>

Organization API key obtained from PropelAuth

In: header

Response Body

application/json

application/json

application/json

curl -X GET 'https://compose.finance/api/v2/customers/withdrawal/allowance' \  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "enabled": true,
  "allowance": {
    "limit": "10000",
    "spent": "2500",
    "available": "7500",
    "resetPeriodMinutes": 1440,
    "nextResetAt": "2024-01-16T00:00:00.000Z"
  }
}

{
  "error": "Unauthorized - Invalid or missing API key or session"
}
{
  "error": "Customers feature is not enabled for this organization"
}