Skip to main content
GET
/
partner
/
cards
/
{id}
Get card
curl --request GET \
  --url https://api.contro.me/v1/partner/cards/{id} \
  --header 'x-contro-api-key: <api-key>'
{
  "id": "card_def456",
  "type": "virtual",
  "brand": "Visa",
  "status": "active",
  "nameOnCard": "JANE DOE",
  "limit": 5000,
  "provider": "stripe",
  "programId": "prog_xyz",
  "createdAt": "2026-03-20T14:30:00Z"
}

Authorizations

​
x-contro-api-key
string
header
required

Partner API key (sk_live_* for production, sk_test_* for sandbox)

Path Parameters

​
id
string
required

Card ID

Example:

"card_def456"

Response

Card details

​
id
string
required

Card ID

Example:

"card_def456"

​
type
string
required

Card type. One of: virtual, physical

Example:

"virtual"

​
brand
string
required

Card network brand. One of: Visa, Mastercard

Example:

"Visa"

​
status
string
required

Current card status. One of: created, active, frozen, cancelled

Example:

"active"

​
nameOnCard
string | null
required

Name embossed on the card, or null for virtual cards

Example:

"JANE DOE"

​
limit
number | null
required

Spending limit in the card's currency unit. null = unlimited

Example:

5000

​
provider
string | null
required

Underlying card provider

Example:

"stripe"

​
programId
string | null
required

Card program this card was issued from

Example:

"prog_xyz"

​
createdAt
string
required

ISO 8601 creation timestamp

Example:

"2026-03-20T14:30:00Z"