List cards
Returns a paginated list of the company’s corporate cards, with optional filters for status, type, cardholder email, product name, and last 4 digits.
Available filters:
status: ACTIVATED, BLOCKED, CANCELLED, INACTIVATEDtype: PHYSICAL, VIRTUALemail: cardholder emailproductName: card product namelast4: last 4 digits of the card number
Use nextPageStartKey to page through results (cursor-based pagination).
curl -X GET "https://api-sandbox.contasimples.com/credit-cards/v1/cards?email=card-owner@gmail.com&status=ACTIVATED&type=PHYSICAL&productName=Marketing Ads&last4=4821&nextPageStartKey=example_string&limit=10" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
import requests
import json
url = "https://api-sandbox.contasimples.com/credit-cards/v1/cards?email=card-owner@gmail.com&status=ACTIVATED&type=PHYSICAL&productName=Marketing Ads&last4=4821&nextPageStartKey=example_string&limit=10"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api-sandbox.contasimples.com/credit-cards/v1/cards?email=card-owner@gmail.com&status=ACTIVATED&type=PHYSICAL&productName=Marketing Ads&last4=4821&nextPageStartKey=example_string&limit=10", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api-sandbox.contasimples.com/credit-cards/v1/cards?email=card-owner@gmail.com&status=ACTIVATED&type=PHYSICAL&productName=Marketing Ads&last4=4821&nextPageStartKey=example_string&limit=10", nil)
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/cards?email=card-owner@gmail.com&status=ACTIVATED&type=PHYSICAL&productName=Marketing Ads&last4=4821&nextPageStartKey=example_string&limit=10')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
response = http.request(request)
puts response.body
{
"items": [
{
"id": "example_string",
"maskedNumber": "example_string",
"cardHolderName": "John Doe",
"responsible": {
"name": "John Doe",
"email": "user@example.com"
},
"type": "PHYSICAL",
"createdAt": "2025-09-15T14:30:00.000Z",
"updatedAt": "2025-09-20T10:00:00.000Z",
"status": "ACTIVATED",
"expirationDate": "2028-12-31T23:59:59.000Z",
"name": "John Doe",
"costCenter": {
"id": "example_string",
"name": "Marketing"
},
"formattedExpirationDate": "12/2028",
"purpose": "FREE"
}
],
"nextPageStartKey": "eyJvZmZzZXQiOjB9",
"limit": 10
}
{
"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"
}
/credit-cards/v1/cards
Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}
Bearer {token}Email of the person responsible for the card.
Card status.
Card type.
Card product name.
Last 4 digits of the card number.
Opaque pagination token from the previous response. Pass it back unchanged to fetch the next page.
Maximum number of cards per page. Minimum: 1.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}
Query Parameters
Email of the person responsible for the card.
Card product name.
Last 4 digits of the card number.
Opaque pagination token from the previous response. Pass it back unchanged to fetch the next page.
Maximum number of cards per page. Minimum: 1.
Responses
List of cards.
Unique card identifier.
Masked card number (e.g. **** **** **** 1234).
Cardholder name on the card.
Card owner details.
Name of the person responsible for the card.
Email of the person responsible for the card.
Card type.
PHYSICALVIRTUALWhen the card was created (ISO 8601).
When the card was last updated (ISO 8601).
Current card status.
ACTIVATEDBLOCKEDCANCELLEDINACTIVATEDCard expiry (ISO 8601).
Display name for the card.
Cost center for the transaction.
Unique cost center identifier.
Cost center name.
Formatted expiry (MM/YYYY).
Intended use of the card.
FREETRIPADSSOFTWAREAERIALHOTELNext page token. If absent, there is no next page. Pass to nextPageStartKey.
Items per page.
Invalid request. Check the parameters you sent.
Unauthorized. Token missing, invalid, or expired.
Resource not found. Check IDs, paths, and permissions.
Internal server error. Retry with exponential backoff.
Last updated today
Built with Documentation.AI