---
title: "Get information on a specific enrolled card"
method: GET
path: "/cards/{card_id}"
tags: ["Account Updater"]
---

# Get information on a specific enrolled card

`GET /cards/{card_id}`

Returns information of enrolled card with the most up-to-date card information available from issuing banks and all VGS Account Updater capabilities.

## Path parameters

- `card_id` string, required

## Response `200`

Enroll card API response.

- EnrollCardData
  - `data` EnrolledCard, required — Payment card object with billing address.
    - `name` string, required — Card owner's full name.
    - `number` string, required — Customer's card number.
    - `exp_month` integer, required — Card's expiration month.
    - `exp_year` integer, required — Card's expiration year.
    - `cvv` string — Card's cvv
    - `merchant` object — AU merchant details.
      - `vgs_merchant_id` string — VGS merchant id.
      - `sub_merchant_name` string — Sub merchant name. Required if you are submitting the card on behalf of a merchant.
      - `sub_merchant_mid` string — Sub merchant MID. In some cases required for PayFac customers
    - `failure_code` 'account-updater-not-supported' | 'merchant-not-found' | 'invalid-exp-date' | 'invalid-payload' | 'invalid-param' | 'internal-server-error' — Application-specific failure code which can only occur with failed state: * `account-updater-not-supported` - Account Updater is not implemented for your card issuer * `merchant-not-found` - No merchant was registered for organization
    - `event` 'au_card.valid' | 'au_card.updated' | 'au_card.expired' | 'au_card.closed' | 'au_card.non_participating' | 'au_card.contact_cardholder_advice' | 'au_card.unknown' | 'au_card.enrolled' | 'au_card.opt_out' — Current state of a card being processed: * `au_card.valid` - Card is valid. Current Account and Expiration Date returned * `au_card.updated` - Card was updated. New Account and Expiration Date returned * `au_card.expired` - Card was expired. New Expiration Date returned * `au_card.closed` - Card was closed. * `au_card.non_participating` - BIN is not participating in AU * `au_card.contact_cardholder_advice` - Cardholder has opted out and the merchant needs to contact cardholder for information * `au_card.unknown` - BIN is participating in AU but there is no match yet * `au_card.enrolled` - PAN and expiration date the merchant provided is up-to-date * `au_card.opt_out` - Cardholder has opted out sharing credential information with the merchants
    - `billing_address` BillingAddress — Internal schema for customer's billing.
      - `name` string
      - `company` string
      - `address1` string
      - `address2` string
      - `city` string
      - `region` string — Principal subdivision in ISO 3166-2
      - `country` string — ISO 3166 alpha 2 country code
      - `postal_code` string
      - `phone` string — Telephone number in E.164
      - `email` string
    - `capabilities` Capability[]
    - `id` string, required — Unique reference identifier for this card
    - `created_at` string, date-time, required — Creation time, in UTC.
    - `updated_at` string, date-time, required — Last time card was updated, in UTC.
    - `state` 'enrolling' | 'enrolled' | 'failed' | 'closed', required — Current state of a card being processed: * `enrolling` - card is in enrolling state and is not yet available for updates * `enrolled` - card was successfully enrolled and is available for Push and Pull updates * `failed` - card enrollment failed, see `failure_code` for details * `closed` - card was closed, but can still be retrieved

## Other responses

- `404` — Not found. Possible error codes: * `card-not-found`
- `500` — Internal Server Error
- `default` — Enroll card API response.

---

[API](https://skmtc.net/verygoodsecurity/apis/vgs-card-management-platform-cmp-api.md) · [All operations](https://skmtc.net/verygoodsecurity/apis/vgs-card-management-platform-cmp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verygoodsecurity/vgs-card-management-platform-cmp-api/revisions/71471c6a84af/schema)