Cards - List
Lista cartões cadastrados (tokenizados) para a conta, com paginação e filtros suportados pelo contrato.
Lista cartões cadastrados (tokenizados) para a conta, com paginação e filtros suportados pelo contrato.
Authorization
SelectKeyAuth API key for all authenticated requests. Send your key in the selectkey header (e.g. sandbox sl_test_…, production sl_live_…).
In: header
Query Parameters
Maximum number of items to return
Number of items to skip
Sort order for results
Filter by card holder (customer) ID
Filter by card ID
Filter to a single calendar day; the API expands this to the start and end of that day for the relevant timestamp field.
Lower bound (exclusive): include only records whose date field is strictly after this value.
Lower bound (inclusive): include only records whose date field is on or after this value.
Upper bound (exclusive): include only records whose date field is strictly before this value.
Upper bound (inclusive): include only records whose date field is on or before this value.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/cards?limit=20&offset=0&sort=descending&holderid=cus_abc123&id=card_abc123&daterange=2026-01-01T00%3A00%3A00Z&daterangegt=2026-01-01T00%3A00%3A00Z&daterangegte=2026-01-01T00%3A00%3A00Z&daterangelt=2026-01-01T00%3A00%3A00Z&daterangelte=2026-01-01T00%3A00%3A00Z"{
"offset": 0,
"limit": 25,
"total": 2,
"hasMore": false,
"page": {
"current": 1,
"total": 1,
"offset": {
"first": 0,
"prev": null,
"next": null,
"last": 0
}
},
"data": [
{
"id": "card_01hqzvabc",
"holderName": "JOÃO SILVA",
"brand": "visa",
"firstDigits": "411111",
"lastDigits": "1111",
"expirationMonth": "12",
"expirationYear": "2025",
"isPrimary": true,
"isActive": true,
"isValid": true,
"isVerified": true,
"isAssociated": true,
"createdAt": "2026-04-12T17:56:33.000Z",
"updatedAt": "2026-04-12T17:56:33.000Z"
},
{
"id": "card_02hqzvxyz",
"holderName": "JOÃO SILVA",
"brand": "mastercard",
"firstDigits": "510000",
"lastDigits": "5555",
"expirationMonth": "06",
"expirationYear": "2026",
"isPrimary": false,
"isActive": true,
"isValid": true,
"isVerified": true,
"isAssociated": true,
"createdAt": "2026-03-15T10:20:00.000Z",
"updatedAt": "2026-03-15T10:20:00.000Z"
}
],
"merchant": {
"name": "Seller Name",
"merchantId": "bus_1234567890",
"isSubAccount": false
},
"_links": {
"self": {
"href": "https://api.selectwin.io/v1/cards",
"method": "GET",
"description": "List all cards."
},
"create": {
"href": "https://api.selectwin.io/v1/cards",
"method": "POST",
"description": "Create and tokenize a new card."
}
}
}{
"error": {
"status": "Bad Request",
"statusCode": 400,
"category": "validation",
"message": "Validation errors occurred",
"details": "One or more parameters are invalid or out of range. Please check the parameters and try again.",
"params": [
{
"payment[currency]": "currency must be one of [BRL]"
},
{
"amount": "amount is required"
}
],
"code": "invalidParameters",
"resource": "client"
}
}{
"error": {
"status": "Unauthorized",
"statusCode": 401,
"category": "authentication",
"message": "Unauthorized",
"details": "Authentication failed. The provided API key is invalid or does not have permission to operate.",
"code": "unauthorized"
}
}{
"error": {
"status": "Forbidden",
"statusCode": 403,
"category": "authorization",
"message": "Forbidden",
"details": "Access denied. This may be due to IP blocks, domain restrictions, or insufficient permissions.",
"code": "forbidden"
}
}{
"error": {
"status": "Not Found",
"statusCode": 404,
"category": "client",
"message": "Not Found",
"details": "The requested resource was not found on the server.",
"code": "notFound"
}
}{
"error": {
"status": "Unprocessable Entity",
"statusCode": 422,
"category": "validation",
"message": "Unprocessable Entity",
"details": "The request was understood, but contains invalid data that could not be processed.",
"code": "unprocessableEntity"
}
}{
"error": {
"status": "Too Many Requests",
"statusCode": 429,
"category": "rate_limit",
"message": "Too Many Requests",
"details": "The number of requests exceeded the limit allowed for the IP or user.",
"retryAfterMinutes": 60,
"code": "tooManyRequests"
}
}{
"error": {
"status": "Internal Server Error",
"statusCode": 500,
"category": "server",
"message": "Server error.",
"details": "An internal server error occurred. Please try again later.",
"code": "serverError",
"resource": "server"
}
}