Gravv docs
Docs Agent Sign in Get API keys

Get saved card

Returns one active saved card by the id from the list. Ignore is_active in this response, as it is always false.

GEThttps://api.gravv.xyz/v1/collections/cards/{card_id}

Path Parameters

The saved card id, not the card token

Responses

Status Description
200 The saved card
400 The request failed. An unknown or inactive card returns saved card not found or inactive: resource not found.

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": false,
"is_expiring_soon": false,
"created_at": "2026-10-01T10:00:00Z"
},
"error": null
}

400 response

{
"data": null,
"error": "saved card not found or inactive: resource not found"
}

Authorization

  • ApiKeyAuth
Was this page helpful?
ESC