---
title: "Revoke Card"
method: POST
path: "/cards/{card_id}/revoke"
tags: ["Cards"]
---

# Revoke Card

`POST /cards/{card_id}/revoke`

## Request

- Base URL: `https://api.meow.com/v1`
- URL: `https://api.meow.com/v1/cards/{card_id}/revoke`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/meow/apis/meow-api/docs/cards/:card_id/revoke/post.ts> (a function with typed inputs; its response is checked against the schema)

Immediately revoke a card. Revoke a card whose purchase failed to close it before it expires.

## Path parameters

- `card_id` string, uuid, required: Card to act on. Use list_cards to find one.

## Headers

- `x-entity-id` string, uuid

## Response `200`

Successful Response

- RevokeCardResponse
  - `card_id` string, uuid, required: The card that was revoked.
  - `status` 'pending' | 'active' | 'suspended' | 'closed' | 'failed', required

## Other responses

- `400`: The request could not be processed.
- `401`: Authentication failed.
- `403`: The API key is not authorized for this operation, or the user of a global API key is an admin or controller without approved KYC. The KYC case returns the message `KYC is required for controllers and admins.` until that user completes KYC in the Meow dashboard.
- `429`: Too many requests.

---

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