SelectwinDOCS
Wallets

Wallets - List all

Listagem completa de carteiras com filtros adicionais, conforme contrato (equivalente a list-all).

GET
/v1/wallets/listall

Listagem completa de carteiras com filtros adicionais, conforme contrato (equivalente a list-all).

Authorization

SelectKeyAuth
selectkey<token>

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

limit?number

Maximum number of items to return

offset?number

Number of items to skip

sort?string

Sort order for results

id?string

Filter by wallet ID

daterange?string

Filter to a single calendar day; the API expands this to the start and end of that day for the relevant timestamp field.

daterangegt?string

Lower bound (exclusive): include only records whose date field is strictly after this value.

daterangegte?string

Lower bound (inclusive): include only records whose date field is on or after this value.

daterangelt?string

Upper bound (exclusive): include only records whose date field is strictly before this value.

daterangelte?string

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/wallets/listall?limit=20&offset=0&sort=descending&id=wall_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"
[
  {
    "id": "wall_01hqzvabc",
    "name": "Conta principal",
    "bankName": "Nubank",
    "bankCode": "260",
    "holderName": "João Santos",
    "routingNumber": "0001",
    "accountNumber": "12345678",
    "primary": true,
    "enabled": true,
    "updatedAt": "2026-04-12T17:56:33.000Z",
    "createdAt": "2026-04-12T17:56:33.000Z"
  }
]
{
  "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"
  }
}