Gravv docs
Docs Agent Sign in Get API keys

Get a card

Returns one card without its full number. daily_transaction_limit is the card's only limit. The format of masked_pan and expiry differs from the list.

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

Path Parameters

ID of the card

Responses

Status Description
200 The card
400 The request failed. Every card error is a 400, including not-found. Read error.

200 response

******* and the last 4 digits

MM/YYYY. Sandbox cards show YYYY-MM-DD, so parse both. Empty when not known.

Possible values: virtual, physical

active can spend. freeze is a temporary hold. blocked is permanent. inactive is issued but not yet activated. An empty value is an application with no card yet.

Possible values: active, freeze, blocked, inactive, ``

One of the following variants:

Required for a physical card. address_line2 is not read.

Send it as a string, so leading zeros are kept

Alpha-2 code

Possible values: standard, express, international, apc, uspsInternational, overnight

  • null (null)

Possible values: virtual, physical

The card's spending limit, in whole USD per day

{
"data": {
"id": "dce0192a-9b3d-440b-9500-33dc9ac8dc20",
"date_created": "2026-10-10T13:04:36.544962Z",
"date_updated": "2026-10-13T17:57:26.56108Z",
"name_on_card": "Jane Doe",
"customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
"blockchain_network": "polygon",
"proxy_address": null,
"masked_pan": "*******9351",
"expiry": "07/2029",
"network": "visa",
"currency": "USD",
"asset": "USDC",
"card_type": "virtual",
"status": "active",
"billing_address": null,
"shipping_address": null,
"spending_controls": {
  "type": "virtual",
  "activated": true,
  "daily_transaction_limit": 50
}
},
"error": null
}

400 response

What went wrong

{
"data": null,
"error": "card does not exist"
}

Authorization

  • ApiKeyAuth
Was this page helpful?
ESC