API Reference

Get a card application

Returns one application. Its status is the card's status and stays empty until a card is issued, so use GET /v1/cards/applications to wait for approval.

GEThttps://api.gravv.xyz/v1/cards/applications/{application_id}

Path Parameters

Responses

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

200 response

Application ID. The first card issued gets the same ID.

The card's status, not the application's. It stays empty until a card is issued, so do not poll it for approval.

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

Verification page for the cardholder, live only. Empty when there is none.

{
"data": {
"id": "a14ec356-f33d-4384-ba68-4d9bfa19765b",
"date_created": "2026-10-01T10:00:00.123456Z",
"date_updated": "2026-10-01T10:05:00.654321Z",
"network": "visa",
"currency": "USD",
"asset": "USDC",
"status": "",
"application_link": "",
"address": null
},
"error": null
}

400 response

What went wrong

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

Authorization

ApiKeyAuth

Was this page helpful?