Cards

Reveal a card

Return the full card number, the security code and the expiry. Reveal only at the moment of use; AgentPay never logs the number.

GET/v1/cards/{id}

Authorization: Bearerid

Live API. A POST to /v1/cards issues a real card.

Authorizations

Authorizationstringrequired

Bearer token: Authorization: Bearer mk_live_.... Create a key in the AgentPay console under Developer, API keys.

Path parameters

idstringrequired

The card id from POST /v1/cards.

Response200application/json

idstring

The card id.

last4string

The last four digits.

numberstring

The full card number.

number_formattedstring

The number in groups of four.

cvcstring

The security code.

expstring

The expiry as MM/YY.

request_idstring

The request id, also in the X-Mooj-Request-Id header.

Errors

Status	Code	When
404	`card_not_found`	No such card on your account.
502	`reveal_failed`	The issuer could not return the card. Retry.

Reveal a card

curl https://api.joomjoo.com/v1/cards/card_8f2a... \
  -H "Authorization: Bearer $AGENTPAY_API_KEY"

import { AgentPay } from "@agentpay-global/sdk";

const agentpay = new AgentPay(process.env.AGENTPAY_API_KEY);
const full = await agentpay.cards.reveal("card_8f2a...");

import os
from agentpay import AgentPay

agentpay = AgentPay(api_key=os.environ["AGENTPAY_API_KEY"])
full = agentpay.cards.reveal("card_8f2a...")

200

{
  "id": "card_8f2a...",
  "last4": "8339",
  "number": "4775xxxxxxxx8339",
  "number_formatted": "4775 xxxx xxxx 8339",
  "cvc": "123",
  "exp": "04/33",
  "request_id": "req_a1b2c3"
}