API Reference

List card applications

Lists your card applications, newest first, with application_status. This is the only route that returns it. Poll it until the status is approved, or wait for the cards.application.update webhook. It takes no filters.

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

Query Parameters

Responses

Status	Description
`200`	A page of applications

200 response

Wait for approved before you issue a card. needs_verification means the cardholder must open application_link.

Possible values: approved, pending, needs_information, needs_verification, manual_review, denied, locked, canceled, ``

{
"data": {
"items": [
  {
    "id": "ac21ddfc-f6ba-432c-abb3-c5e2243e8ef7",
    "customer_id": "1805c3be-abca-4698-9cbd-789fc1d619eb",
    "date_created": "2026-10-05T10:48:18.170061Z",
    "date_updated": "2026-10-06T15:31:40.273281Z",
    "application_status": "approved",
    "application_link": ""
  }
],
"items_per_page": 10,
"page": 1,
"total_items": 1,
"total_pages": 1
},
"error": null
}

Authorization

ApiKeyAuth

Was this page helpful?