Pular para o conteúdo principal
GET
/
v1
/
exceptions
/
ids
Selecionar IDs de exceção por filtro
curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/exceptions/ids \
  --header 'Authorization: Bearer <token>'
{
  "ids": [
    "<string>"
  ],
  "total": 123,
  "truncated": true
}

Autorizações

​
Authorization
string
header
obrigatório

Autenticação por Bearer token (formato: "Bearer {token}")

Parâmetros de consulta

​
contextId
string<uuid>

Filter by reconciliation context ID (UUID, verified against the tenant; 404 when unknown) Filtrar por ID do contexto de reconciliação (UUID, verificado contra o tenant; 404 quando desconhecido)

Exemplo:

"550e8400-e29b-41d4-a716-446655440000"

​
status
enum<string>

Filter by status Filtrar por status

Opções disponíveis:
OPEN,
ASSIGNED,
RESOLVED
​
severity
enum<string>

Filter by severity Filtrar por severidade

Opções disponíveis:
LOW,
MEDIUM,
HIGH,
CRITICAL
​
reason
enum<string>

Filter by exception reason Filtrar por motivo da exceção

Opções disponíveis:
UNMATCHED,
FX_RATE_UNAVAILABLE,
MISSING_BASE_AMOUNT,
MISSING_BASE_CURRENCY,
SPLIT_INCOMPLETE,
VALIDATION_FAILED,
SOURCE_MISMATCH,
DUPLICATE_TRANSACTION,
FEE_VARIANCE,
FEE_DATA_MISSING,
FEE_CURRENCY_MISMATCH,
FX_RATE_VARIANCE,
AGED_BREAK,
OVER_SETTLED
​
assigned_to
string

Filter by assigned user Filtrar por usuário atribuído

Exemplo:

"user@example.com"

​
external_system
string

Filter by external system Filtrar por sistema externo

Exemplo:

"JIRA"

​
search
string

Free-text search across transaction id, reason, and external issue id (case-insensitive substring match) Busca em texto livre em ID da transação, motivo e ID de issue externo (correspondência de substring sem distinção de maiúsculas)

Exemplo:

null

​
date_from
string

Filter from date, inclusive lower bound. Accepts an RFC 3339 timestamp or a bare date (YYYY-MM-DD); a bare date is taken at 00:00:00 UTC Filtrar a partir da data, limite inferior inclusivo. Aceita um timestamp RFC 3339 ou uma data simples (YYYY-MM-DD); uma data simples é tomada às 00:00:00 UTC

Exemplo:

"2025-01-01T00:00:00Z"

​
date_to
string

Filter to date, inclusive upper bound. Accepts an RFC 3339 timestamp or a bare date (YYYY-MM-DD); a bare date covers the whole day through 23:59:59.999999999 UTC Filtrar até a data, limite superior inclusivo. Aceita um timestamp RFC 3339 ou uma data simples (YYYY-MM-DD); uma data simples cobre o dia inteiro até 23:59:59.999999999 UTC

Exemplo:

"2025-01-31T23:59:59Z"

​
min_age_days
integer<int64>

Filter to exceptions at least this many days old (by created_at). 0 (default) disables the filter. Filtrar para exceções com pelo menos esta quantidade de dias (por created_at). 0 (padrão) desativa o filtro.

Intervalo obrigatório: 0 <= x <= 3650
Exemplo:

30

Resposta

OK

​
ids
string[] | null
obrigatório

IDs de exceção que correspondem ao filtro, ordenados deterministicamente (created_at DESC, id DESC), limitados a 10000

Maximum array length: 10000
​
total
integer<int64>
obrigatório

Total de exceções que correspondem ao filtro (conjunto completo; pode exceder os IDs retornados)

Exemplo:

530

​
truncated
boolean
obrigatório

Verdadeiro quando o conjunto filtrado excede os IDs retornados (o limite foi atingido); uma única passagem em lote não cobrirá toda correspondência

Exemplo:

false