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,
  "last4": "0000",
  "programId": "prog_xyz",
  "createdAt": "2026-03-20T14:30:00Z",
  "spendControl": {
    "sales": {
      "perTransaction": 200,
      "daily": 1000,
      "monthly": 20000,
      "allTime": 50000
    },
    "cash": {
      "perTransaction": 200,
      "daily": 1000,
      "monthly": 20000,
      "allTime": 50000
    },
    "spent": {
      "sales": {
        "perTransaction": 200,
        "daily": 1000,
        "monthly": 20000,
        "allTime": 50000
      },
      "cash": {
        "perTransaction": 200,
        "daily": 1000,
        "monthly": 20000,
        "allTime": 50000
      }
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://partner-docs.contro.dev/llms.txt

Use this file to discover all available pages before exploring further.

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
deprecated

Deprecated. Mirrors spendControl.sales.allTime. Use spendControl for per-transaction-type velocity caps.

Example:

5000

​
last4
string | null
required

Last 4 digits of the card number

Example:

"0000"

​
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"

​
spendControl
object

Per-transaction-type velocity caps and accrued spend. null/omit = no caps.