Platforms / API

Build with the AgentCard API

Programmatic card issuing for platforms and agents. Authenticate with an API key, create cards, manage cardholders.

Full docs →
$ curl -X POST https://api.agentcard.sh/api/v1/cards \  -H "Authorization: Bearer sk_test_..." \  -H "Content-Type: application/json" \  -d '{"amountCents": 2500}'

Get your API key

Click a step to see the command. Four steps from zero to API access.

Step 01 of 04
$ npm install -g agent-cards-admin
added 47 packages in 3s
Next: Step 02

Every endpoint

The full reference for the AgentCard REST API. All endpoints require an Authorization: Bearer sk_test_... header.

Issue a single-use virtual Visa card with a spending limit. Cards auto-cancel after one authorized payment.

amountCentsSpending limit in cents (positive integer, max $5000)(required)
cardholderIdID of cardholder; uses org owner if omitted

List all cards in your organization with optional filters and pagination.

statusFilter by card status (OPEN, CLOSED)
cardholderIdFilter by cardholder ID
limitResults per page (1-100, default 50)
offsetPagination offset (default 0)

Get a card summary — last 4, expiry, balance, and status. Does not include PAN or CVV.

:idCard ID(required)

Get full card credentials including decrypted PAN and CVV. Use for checkout flows.

:idCard ID(required)

Close a card immediately. Releases held funds and cancels the card at the provider.

:idCard ID(required)

Create a cardholder in your organization. Required before issuing cards to specific individuals.

firstNameCardholder first name(required)
lastNameCardholder last name(required)
dateOfBirthISO date string (e.g. "1990-01-15")(required)
phoneNumberPhone number(required)
emailEmail address

Start building

Get your API key from the dashboard and start issuing cards programmatically.

Full docs →