logo
CardsBlock card

Block card

Blocks a corporate card by ID. You may include an optional block reason in the request body.

Note: a blocked card can be unblocked later with the unblock endpoint.

curl -X POST "https://api-sandbox.contasimples.com/credit-cards/v1/example_string/block" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "reason": "Blocked by the user via API"
}'
{}
POST
/credit-cards/v1/{id}/block
POST
Bearer Token
Bearer Tokenstring
Required

Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}

Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}
path
idstring
Required

Unique card identifier.

Content-Typestring
Required

The media type of the request body

Options: application/json
reasonstring

Reason the card was blocked.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}

Path Parameters

idstring
Required

Unique card identifier.

Body

application/json
reasonstring

Reason the card was blocked.

Responses