---
title: "Check a card for updates in VGS Account Updater"
method: POST
path: "/card-check"
tags: ["Account Updater"]
---

# Check a card for updates in VGS Account Updater

`POST /card-check`

Stateless api to fetch card updates without persisting any state
VGS Account Updater will perform both card availability and eligibility checks to check that this specific card is eligible for management.

## Request body

- Card — Payment card object.
  - `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

## Response `202`

Card check API response.

- CheckCardData
  - `data` CheckedCard, required — Payment card object.
    - `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

## Other responses

- `400` — Bad Request
- `404` — Vgs Merchant Not found
- `422` — Unprocessable Entity. Possible error codes: * `card-brand-not-supported` * `account-updater-not-supported`
- `500` — Internal Server Error
- `default` — Card check 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)