---
title: "Subscribe"
method: POST
path: "/cards/{card_id}/card-update-subscriptions"
tags: ["Account Updater"]
---

# Subscribe

`POST /cards/{card_id}/card-update-subscriptions`

## Request

- Base URL: `https://sandbox.vgsapi.com`
- URL: `https://sandbox.vgsapi.com/cards/{card_id}/card-update-subscriptions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/verygoodsecurity/apis/vgs-card-management-platform-cmp-api/docs/cards/:card_id/card-update-subscriptions/post.ts> (a function with typed inputs; its response is checked against the schema)

To begin receiving automated updates for a card, it must be enrolled in account updater using the **Subscribe** operation. This API enables continuous tracking of card status with the issuing network. If the card is already subscribed, the system will automatically skip re-enrollment.
Subscribing ensures that your application will receive updates on card replacements, expiration changes, and other important lifecycle events, keeping your records accurate without customer input.

## Path parameters

- `card_id` string, required

## Response `200`

Card subscription details

- CardUpdateSubscriptionResourceResponse
  - `data` CardUpdateSubscriptionResource, required: An object representing a card account updater subscription. A card update subscription receives updates from the card network when the card is renewed or replaced.
    - `id` string: ID of card update subcription.
    - `type` 'card_updates' | 'card_update_subscriptions' | 'network_tokens'
    - `attributes` object
      - `bin` string, \d{6,10}: The leading six or eight digits of the related card are the issuer identification number (IIN) sometimes referred to as the bank identification number (BIN).
      - `created_at` string, date-time
      - `state` 'enrolled' | 'failed': State of the card update subscription.
      - `updated_at` string, date-time

## Other responses

- `201`: Card subscription details
- `400`: The request was invalid.
- `403`: Valid credentials were provided, but they do not permit access to this resource.
- `404`: Resource not found.
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/verygoodsecurity/apis/vgs-card-management-platform-cmp-api.md) - [All operations](https://skmtc.dev/verygoodsecurity/apis/vgs-card-management-platform-cmp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verygoodsecurity/apis/vgs-card-management-platform-cmp-api/revisions/71471c6a84af?raw)