Programmatic access
to every capability.
Every CLI command maps to a REST endpoint. Authenticate with API keys, manage agents, cards, IBANs, credit, and payments programmatically. Available on the Pro plan.
API key authentication.
Login via the CLI, then use aipay auth token to get your bearer token. Include it in the Authorization header for all API requests.
Optionally scope API calls to a specific agent by including the agent ID in the header. This ensures agent-level isolation and audit trail attribution.
Nine resource groups.
Base URL: https://api.aipay.sh/v1
Register agents, list agents, retrieve agent details and credentials.
Issue virtual cards, retrieve PAN/CVV, freeze, cancel, and list transactions.
Provision virtual IBANs, check balances, transfer funds between accounts.
View credit line status, allocate credit to agents, check repayment schedule.
Create spending policies, list active rules, remove policies by ID.
List pending invoices, trigger payment, track settlement status.
Get exchange rates, fund cards from USDC/USDT, retrieve deposit addresses.
Query audit log with filters for agent, type, date range. Export as CSV or JSON.
Send magic links, verify tokens, check session status, and validate API keys.
Create a card
in one request.
POST to /v1/cards with amount, currency, and agent ID. Get back a full card object with PAN, CVV, and expiry.
Built for scale.
Per API key. Burst up to 100 concurrent requests. Higher limits available on Enterprise.
Versioned via URL path. Breaking changes ship in new versions. Old versions supported for 12 months.
All list endpoints support cursor pagination. Default page size: 50. Max: 200.