{ } API

Issue cards for your agents via API.

Programmatic card issuing for platforms and agents. Authenticate with a token and operate accounts, cards, grants and authorizations. Amounts are in cents.

bash

curl https://cardia-api.emipanelli.com/admin/cards \
  -H "x-admin-token: $CARDIA_API_TOKEN"

Base: https://cardia-api.emipanelli.com · Authenticate every request with the x-admin-token header.

bash

$ curl -X POST https://cardia-api.emipanelli.com/admin/cards \

-H "x-admin-token: $CARDIA_API_TOKEN" \

-H "Content-Type: application/json" \

-d '{ "currency": "USD", "mode": "scoped" }'

HTTP/1.1 201 Created

{

"id": "card_02",

"currency": "USD",

"mode": "scoped",

"last4": "8841",

"balanceCents": 0

} ▋

Endpoints

Accounts

GET/admin/accounts

Lists accounts. Each includes balances { ARS, USD } in cents.

POST/admin/accounts/:id/cash-in

Credits balance. Body: { amountCents, currency, idempotencyKey }.

POST/admin/accounts/:id/cash-out

Debits balance. Body: { amountCents, currency, idempotencyKey }.

POST/admin/accounts/:id/exchange

Converts between balances. Body: { fromCurrency, toCurrency, amountCents }.

Cards

GET/admin/cards

Lists cards, with currency 'ARS'|'USD' and mode 'free'|'scoped'.

POST/admin/cards

Issues cards. Without accountId it creates account + 2 cards (ARS and USD).

PATCH/admin/cards/:id/mode

Changes the mode. Body: { mode: 'free'|'scoped' }.

Grants

GET/admin/permissions

Lists grants. Filter with ?cardId=.

POST/admin/permissions

Creates a grant. Body: { cardId, merchant, maxAmountCents, ttlSeconds }.

POST/admin/permissions/:id/cancel

Cancels an active grant.

Authorizations

POST/admin/authorizations/simulate

Simulates a purchase. Body: { cardId, merchant, amountCents } → { status, reason }.

GET/admin/authorizations

Lists transactions (authorizations).

Example: simulate an authorization

bash

$ curl -X POST https://cardia-api.emipanelli.com/admin/authorizations/simulate \

-H "x-admin-token: $CARDIA_API_TOKEN" \

-H "Content-Type: application/json" \

-d '{ "cardId": "card_01", "merchant": "Jumbo", "amountCents": 1200000 }'

response

{

"status": "APPROVED",

"reason": "active grant · Jumbo · ≤ $50,000"

}

CLI→MCP→Docs (ES)→

Ready to give your agent a card?

Join the waitlist and try the authorizer live in the demo.

Join →Try the demo