---
title: "Card status change"
method: POST
path: "cards#card-status-change"
tags: ["webhook-event", "card"]
---

# Card status change

`POST cards#card-status-change` (webhook)

This event is triggered for the initial card status as well as any subsequent updates.
See the [Webhooks guide](/guides/developer/webhooks) for setup instructions, signature verification, and best practices.

Events may not be delivered in the order they occurred. Use `data.occurred_at` to reconcile the order.
See the [Event Ordering](/guides/developer/webhooks/event-ordering) guide for details.

* Event type: `cards#card-status-change`
* Profile level subscriptions: Not Supported
* Application level subscriptions: Supported

## Headers

- `X-Signature-SHA256` string
- `X-Delivery-Id` string, uuid
- `X-Test-Notification` boolean

## Payload

- union
  - V4007
    - `schema_version` '4.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event
    - `event_type` string — Event type identifier
    - `sent_at` string, date-time — Timestamp when the event was sent
    - `data` object
      - `resource` object
        - `profile_id` integer — ID of the profile that owns the card
        - `client_id` string — Your api_client_id
        - `card_token` string — Unique identifier of the card
        - `type` string — Resource type (always `card`)
      - `card_status` string — The updated card status. Possible values: - `ACTIVE` - Card is active and can be used - `INACTIVE` - Card is inactive and all transactions will be declined - `BLOCKED` - Card is blocked and cannot be reversed back to any state - `FROZEN` - Card is "blocked" but temporarily - `PARTNER_SUSPENDED` - Card is suspended by Wise temporarily due to e.g. fraud reasons - `EXPIRED` - Card is expired - `PURGED` - The cardhoder data (e.g. PAN, PIN) have been purged after exceeds the retention period (555 days after the card's expiry date)
      - `changed_by` string — The identifier of the entity that updated the card status. If changed by Wise, the value is set to `internal_system`, otherwise, it is set to your api_client_id
      - `occurred_at` string, date-time — When the card status change occurred
  - V2007
    - `schema_version` '2.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event
    - `event_type` string — Event type identifier
    - `sent_at` string, date-time — Timestamp when the event was sent
    - `data` object
      - `resource` object
        - `profile_id` integer — ID of the profile that owns the card
        - `client_id` string — Your api_client_id
        - `card_token` string — Unique identifier of the card
        - `type` string — Resource type (always `card`)
      - `card_status` string — The updated card status. Possible values: - `ACTIVE` - Card is active and can be used - `INACTIVE` - Card is inactive and all transactions will be declined - `BLOCKED` - Card is blocked and cannot be reversed back to any state - `FROZEN` - Card is "blocked" but temporarily - `PARTNER_SUSPENDED` - Card is suspended by Wise temporarily due to e.g. fraud reasons - `EXPIRED` - Card is expired - `PURGED` - The cardholder data (e.g. PAN, PIN) have been purged after exceeds the retention period (555 days after the card's expiry date)
      - `changed_by` string — The identifier of the entity that updated the card status. If changed by Wise, the value is set to `internal_system`, otherwise, it is set to your api_client_id
      - `occurred_at` string, date-time — When the card status change occurred

## Acknowledgement `200`

Return any `2xx` status to acknowledge receipt of the event.

- object
  - `status` string

---

[API](https://skmtc.dev/wise/apis/platform-api.md) · [All operations](https://skmtc.dev/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/f3e7a0f6519a/schema)