Pular para o conteúdo principal
GET
Listar Regras

Autorizações

X-API-Key
string
header
obrigatório

Autenticação por API Key. Usada por implantações single-tenant (MULTI_TENANT_ENABLED=false). Enviada em todas as requisições /v1/*.

Cabeçalhos

Content-Type
string
obrigatório

O tipo de mídia do recurso. Deve ser application/json.

X-API-Key
string
obrigatório

A chave de API para autenticação. Este header é obrigatório para todos os endpoints, exceto verificações de integridade.

X-Request-Id
string<uuid>

Um identificador único usado para rastrear cada requisição.

Parâmetros de consulta

limit
integer
padrão:10

O número máximo de itens a incluir na resposta. Padrão: 10, Máx: 100

Intervalo obrigatório: 1 <= x <= 100
cursor
string

Cursor de paginação da resposta anterior.

name
string

Filtrar por nome (correspondência parcial, sem distinção de maiúsculas/minúsculas).

Maximum string length: 255
status
enum<string>

Filtrar por status (DRAFT, ACTIVE, INACTIVE). Regras com status DELETED não são listáveis.

Opções disponíveis:
DRAFT,
ACTIVE,
INACTIVE
action
enum<string>

Filtrar por ação (ALLOW, DENY, REVIEW).

Opções disponíveis:
ALLOW,
DENY,
REVIEW
account_id
string<uuid>

Filtrar por ID de conta (UUID).

segment_id
string<uuid>

Filtrar por ID de segmento (UUID).

portfolio_id
string<uuid>

Filtrar por ID de portfólio (UUID).

merchant_id
string<uuid>

Filtrar por ID de merchant (UUID).

transaction_type
enum<string>

Filtrar por tipo de transação.

Opções disponíveis:
CARD,
WIRE,
PIX,
CRYPTO
sub_type
string

Filtrar por subtipo de transação (ex.: débito, crédito, pré-pago).

Maximum string length: 50
sort_by
enum<string>
padrão:created_at

O campo usado para ordenar os resultados.

Opções disponíveis:
created_at,
updated_at,
name,
status
sort_order
enum<string>
padrão:DESC

A ordem usada para ordenar os resultados.

Opções disponíveis:
ASC,
DESC

Resposta

Indica que a requisição foi bem-sucedida e a resposta contém os dados esperados.

Lista paginada de regras.

rules
object[]

Lista de registros de regras.

hasMore
boolean

Se há mais resultados disponíveis.

nextCursor
string | null

Cursor para buscar a próxima página. Nulo se não houver mais resultados.