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"
}'
import requests
import json
url = "https://api-sandbox.contasimples.com/credit-cards/v1/example_string/block"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
"reason": "Blocked by the user via API"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://api-sandbox.contasimples.com/credit-cards/v1/example_string/block", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
},
body: JSON.stringify({
"reason": "Blocked by the user via API"
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"reason": "Blocked by the user via API"
}`)
req, err := http.NewRequest("POST", "https://api-sandbox.contasimples.com/credit-cards/v1/example_string/block", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api-sandbox.contasimples.com/credit-cards/v1/example_string/block')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request.body = '{
"reason": "Blocked by the user via API"
}'
response = http.request(request)
puts response.body
{}
{
"error": "Bad Request",
"message": "The request contains invalid parameters or malformed data",
"code": 400,
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
{
"error": "Internal Server Error",
"message": "An unexpected error occurred on the server",
"code": 500,
"requestId": "req_1234567890"
}
POST
/credit-cards/v1/{id}/blockPOST
Bearer Token
Bearer Tokenstring
RequiredBearer token from OAuth 2.0 client credentials. Format: Bearer {token}
Bearer token from OAuth 2.0 client credentials. Format:
Bearer {token}path
idstring
RequiredUnique card identifier.
Content-Typestring
RequiredThe 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
RequiredBearer token. Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}
Path Parameters
idstring
RequiredUnique card identifier.
Body
application/json
reasonstring
Reason the card was blocked.
Responses
Card blocked successfully.
Invalid request. Check the card ID and parameters.
Unauthorized. Token missing, invalid, or expired.
Card not found.
Internal server error. Retry with exponential backoff.
Was this page helpful?
Last updated today
Built with Documentation.AI