Saltar al contenido principal
GET
Listar Limites

Autorizaciones

X-API-Key
string
header
requerido

Autenticación por API Key. Utilizada por los despliegues de inquilino único (MULTI_TENANT_ENABLED=false). Se envía en cada solicitud /v1/*.

Encabezados

Content-Type
string
requerido

El tipo de medio del recurso. Debe ser application/json.

X-API-Key
string
requerido

La clave API para autenticacion. Este encabezado es requerido para todos los endpoints excepto verificaciones de salud.

X-Request-Id
string<uuid>

Un identificador unico usado para rastrear y seguir cada solicitud.

Parámetros de consulta

limit
integer
predeterminado:10

El numero maximo de elementos a incluir en la respuesta. Predeterminado: 10, Maximo: 100

Rango requerido: 1 <= x <= 100
cursor
string

Cursor de paginacion de la respuesta anterior.

name
string

Filtrar por nombre de límite (coincidencia exacta).

status
enum<string>

Filtrar por estado (DRAFT, ACTIVE, INACTIVE). Los limites DELETED no son listables.

Opciones disponibles:
DRAFT,
ACTIVE,
INACTIVE
limit_type
enum<string>

Filtrar por tipo de limite.

Opciones disponibles:
DAILY,
WEEKLY,
MONTHLY,
CUSTOM,
PER_TRANSACTION
account_id
string<uuid>

Filtrar por ID de cuenta (UUID).

segment_id
string<uuid>

Filtrar por ID de segmento (UUID).

portfolio_id
string<uuid>

Filtrar por ID de portafolio (UUID).

merchant_id
string<uuid>

Filtrar por ID de comerciante (UUID).

transaction_type
enum<string>

Filtrar por tipo de transacción.

Opciones disponibles:
CARD,
WIRE,
PIX,
CRYPTO
sub_type
string

Filtrar por subtipo de transacción (p. ej., débito, crédito, prepago).

Maximum string length: 50
sort_by
enum<string>
predeterminado:created_at

El campo utilizado para ordenar los resultados.

Opciones disponibles:
created_at,
updated_at,
name,
max_amount
sort_order
enum<string>
predeterminado:DESC

El orden utilizado para ordenar los resultados.

Opciones disponibles:
ASC,
DESC

Respuesta

Indica que la solicitud fue exitosa y la respuesta contiene los datos esperados.

Lista paginada de limites de gasto.

limits
object[]

Lista de registros de limites.

hasMore
boolean

Si hay mas resultados disponibles.

nextCursor
string | null

Cursor para obtener la siguiente pagina. Null si no hay mas resultados.