Get the agency wallet balance

The agency's own (organization-level) wallet balance — not a sub-account wallet.

GET https://api.centerfy.ai/webhooks/inbound/agency/wallet

Headers

Header	Required	Value	Description
`x-api-key`	Yes	your agency API key (cfy_…)	Agency (organization-wide) API key, created in the agency workspace under Settings → API Keys (“Agency API Keys”; the tab only appears on White Label or SaaS Mode plans). Or send Authorization: Bearer `<key>`; x-api-key wins if both are present. Keys must start with cfy_. A sub-account key is rejected with 401.

Example

curl -X GET "https://api.centerfy.ai/webhooks/inbound/agency/wallet" \
  -H "x-api-key: $CENTERFY_AGENCY_API_KEY"

import { CenterfyAgencyClient } from "@centerfy/sdk";

const agency = new CenterfyAgencyClient({ apiKey: process.env.CENTERFY_AGENCY_API_KEY! });

const result = await agency.wallet.get();
console.log(result);

centerfy --agency wallet get

MCP tool: centerfy_agency_wallet_get (see MCP server)

Response

{
  "status": "success",
  "wallet": {
    "balance": 1250.5,
    "wallet_exists": true
  }
}

Errors

401 — when the key is missing, not cfy_-prefixed or unknown (including sub-account keys); 403 when the agency is not on a White Label or SaaS Mode plan; 429 above 50 requests per minute per agency (Retry-After header set); 500 ‘database error’ on an internal failure.

Notes

balance is rounded to 2 decimals. wallet_exists is false when the agency has no wallet row yet; balance then comes from the newest agency-level ledger entry, or 0. Read-only — there is no top-up endpoint.