Skip to main content
GET
/
partner
/
card-programs
/
{id}
Get card program
curl --request GET \
  --url https://api.contro.me/v1/partner/card-programs/{id} \
  --header 'x-contro-api-key: <api-key>'
{
  "id": "prog_xyz",
  "name": "US Virtual Visa",
  "description": "Virtual Visa cards for US customers",
  "type": "virtual",
  "provider": "stripe",
  "brand": "Visa",
  "currency": "USD",
  "region": "US",
  "image": null,
  "active": true,
  "createdAt": "2026-01-01T00:00: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 program ID

Example:

"prog_xyz"

Response

Card program details

​
id
string
required

Card program ID

Example:

"prog_xyz"

​
name
string
required

Human-readable program name

Example:

"US Virtual Visa"

​
description
string | null
required

Program description, or null

Example:

"Virtual Visa cards for US customers"

​
type
string
required

Card type. One of: virtual, physical

Example:

"virtual"

​
provider
string
required

Underlying card provider

Example:

"stripe"

​
brand
string
required

Card network brand. One of: Visa, Mastercard

Example:

"Visa"

​
currency
string
required

ISO 4217 currency code for this program

Example:

"USD"

​
region
string | null
required

Geographic region, or null for global programs

Example:

"US"

​
image
string | null
required

Card art image URL, or null

Example:

null

​
active
boolean
required

Whether the program is currently available for card issuance

Example:

true

​
createdAt
string
required

ISO 8601 creation timestamp

Example:

"2026-01-01T00:00:00Z"