API reference
Cards
Generated HTTP reference for the 1 operation the published OpenAPI document describes under cards.
1 min read
Cards
This page is generated from the published OpenAPI document. It is complete with respect to that document and says nothing about surfaces the document does not describe yet. See what is generated here for what that means.
Base URL: https://api.codespar.dev
Every operation below requires a Bearer token. See Authentication.
GET /v1/cards/{id}
Read an issued card, or the mint flow that is producing one
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | yes | A card row id, or an imf_ prefixed mint flow id. The prefix selects which. |
Responses
| Status | Body | Description |
|---|---|---|
200 | object | object | OK |
404 | object | issuer_card_unknown for both misses, with different messages: mint flow not found for an imf_ id and issuer card not found otherwise. One code, so a client cannot tell a wrong id from another project's id by reading the code. |
Example response
{
"id": "obj_0000000000000000",
"issuer": "pomelo",
"card_id": "card_0000000000000000",
"last4": "string",
"network": "visa",
"status": "active",
"created_at": "2026-01-15T12:00:00.000Z"
}Example request
curl -X GET https://api.codespar.dev/v1/cards/{id} \
-H "Authorization: Bearer $CODESPAR_API_KEY"