---
title: "Retrieve a Card"
method: GET
path: "/payments/cards/{card_id}"
tags: ["Payments", "Card Account Updates"]
---

# Retrieve a Card

`GET /payments/cards/{card_id}`

## Request

- Base URL: `https://api.evervault.com`
- URL: `https://api.evervault.com/payments/cards/{card_id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/evervault/apis/evervault-api/docs/payments/cards/:card_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a Card by its unique identifier.

## Path parameters

- `card_id` string, required

## Response `200`

Returns an existing Card object.

- Card
  - `id` string: The unique identifier for the card.
  - `number` string, required: The Evervault encrypted card number. This can be decrypted using Relay decryption or using a function.
  - `expiry` CardExpiry: The card expiry date.
    - `month` string, required: The card expiry month, in MM format (e.g. 12 for December)
    - `year` string, required: The card expiry year, in YY format (e.g. 29 for 2029)
  - `bin` string, required: The first 6 or 8 digits of the card number.
  - `lastFour` string, required: The last 4 digits of the card number.
  - `brand` 'visa' | 'mastercard' | 'american-express' | 'discover' | 'diners-club' | 'jcb' | 'unionpay': The card brand associated with the payment card.
  - `funding` 'debit' | 'credit' | 'prepaid' | 'deferred-debit' | 'charge': The card funding type specifies the method by which transactions are financed.
  - `segment` 'consumer' | 'commercial' | 'business' | 'government' | 'payouts' | 'all': The card segment indicates the primary market or usage category of the card.
  - `country` string, iso-3166-1-alpha-2: The country where the card was issued.
  - `currency` string, iso-4217-alphabetic: The currency of the card.
  - `issuer` string: The name of the card issuer.
  - `status` 'active' | 'replaced' | 'closed' | 'invalid': The current status of the card.
  - `replacement` string, nullable: The ID of the replacement card. This field is only present if the card has been replaced.
  - `automaticUpdates` 'enabled' | 'issuer-not-enrolled' | 'disabled': The status of Card Account Updater on this card. Evervault currently supports Card Account Updates for Visa, Mastercard and American Express cards.
  - `createdAt` integer, required: The Unix timestamp of when the card was created.
  - `updatedAt` integer, nullable: The Unix timestamp of when the card was last updated.

## Changes

- **2026-11-06** `8d0ca833fa04`: 1 info
  - removed the `cardholder-opted-out` enum value from the `automaticUpdates` response property for the response status `200`
- **2026-04-17** `5e1eb58d42d5`: 2 info
  - the `country` response's property pattern `^[a-z]{2}$` was removed for the status `200`
  - the `currency` response's property pattern `^[a-z]{3}$` was removed for the status `200`
- **2025-11-18** `30ea25af4354`: 3 info
  - api tag `Card Account Updates` added
  - api tag `Payments` added
  - api tag `payments` removed

[Operation history](https://skmtc.dev/evervault/apis/evervault-api/changes/payments/cards/:card_id/get.md)

---

[API](https://skmtc.dev/evervault/apis/evervault-api.md) - [All operations](https://skmtc.dev/evervault/apis/evervault-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evervault/apis/evervault-api/revisions/8d0ca833fa04?raw)