Skip to main content
GET
/
v1
/
delegates
/
{delegateToken}
/
balance
curl -X GET https://api.delegare.dev/v1/delegates/dtok_abc123xyz789/balance \
  -H "X-Delegare-Merchant-Id: your_merchant_id" \
  -H "X-Delegare-Api-Key: your_api_key"
{
  "status": "active",
  "maxMonthlySpendCents": 5000,
  "currentMonthlySpendCents": 1500,
  "remainingMonthlySpendCents": 3500,
  "maxPerTxCents": 1000
}
Retrieve the spending limits and the currently available balance for a specific delegate token.

Headers

X-Delegare-Merchant-Id
string
required
Your merchant identifier.
X-Delegare-Api-Key
string
required
Your merchant API key.

Path Parameters

delegateToken
string
required
The delegateToken used to authorize charges.

Response

status
string
The status of the delegate (active, revoked, expired).
maxMonthlySpendCents
integer
The total authorized monthly spend limit.
currentMonthlySpendCents
integer
The total amount spent by this delegate so far in the current month.
remainingMonthlySpendCents
integer
The remaining available balance for the current month.
maxPerTxCents
integer
The maximum permitted amount for a single transaction.
curl -X GET https://api.delegare.dev/v1/delegates/dtok_abc123xyz789/balance \
  -H "X-Delegare-Merchant-Id: your_merchant_id" \
  -H "X-Delegare-Api-Key: your_api_key"
{
  "status": "active",
  "maxMonthlySpendCents": 5000,
  "currentMonthlySpendCents": 1500,
  "remainingMonthlySpendCents": 3500,
  "maxPerTxCents": 1000
}