API Reference

Get saved cards

Lists a customer's saved cards, default card first, then newest. The list includes cards that are not active yet; only a card with is_active true can be charged.

GEThttps://api.gravv.xyz/v1/collections/cards

Query Parameters

The customer's ID. Always send it.

When set, Gravv matches cards by this value only and does not filter by customer_id.

Responses

Status	Description
`200`	The saved cards
`400`	The request failed. A missing or invalid `customer_id` returns `invalid customer_id format: invalid input`.

200 response

Card ID for GET /v1/collections/cards/{card_id}

Token to charge or delete the card

Only an active card can be charged. A card is inactive until its first payment settles.

True when the card expires within 30 days

Billing details saved with the card, when there are any

{
"data": [
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "card_token": "tokn_80aebb6ea2594a74bc",
  "card_last4": "1111",
  "card_brand": "visa",
  "card_exp_month": "12",
  "card_exp_year": "2028",
  "is_default": true,
  "is_active": true,
  "cardholder_name": "JANE DOE",
  "is_expiring_soon": false,
  "billing_info": {
    "first_name": "Jane",
    "last_name": "Doe",
    "country": "US"
  },
  "created_at": "2026-10-01T10:00:00Z"
}
],
"error": null
}

400 response

{
"data": null,
"error": "invalid customer_id format: invalid input"
}

Authorization

ApiKeyAuth

Was this page helpful?