> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Selecionar IDs de exceção por filtro > Resolve os ids de cada exceção que corresponde ao MESMO filtro de GET /v1/exceptions (status, severity, contextId, reason, assigned_to, external_system, search, date_from, date_to, min_age_days), até um limite de 10000, para o caminho de "selecionar todas correspondentes" em lote. A resposta carrega o total filtrado e um flag truncado; o cliente fragmenta os ids retornados nas chamadas de ação em lote limitadas. Sem paginação/classificação: retorna o conjunto filtrado inteiro (limitado). ## OpenAPI ````yaml pt/openapi/v3-current/matcher.yaml get /v1/exceptions/ids openapi: 3.1.0 info: title: Matcher APIs description: >- Referência completa de API para o motor de conciliação Matcher, que fornece conciliação automática de transações entre o Midaz Ledger e sistemas externos. version: 4.1.0 license: name: Elastic License 2.0 url: https://www.elastic.co/licensing/elastic-license servers: - url: https://matcher.sandbox.lerian.net security: [] paths: /v1/exceptions/ids: get: tags: - Exception summary: Selecionar IDs de exceção por filtro description: >- Resolve os ids de cada exceção que corresponde ao MESMO filtro de GET /v1/exceptions (status, severity, contextId, reason, assigned_to, external_system, search, date_from, date_to, min_age_days), até um limite de 10000, para o caminho de "selecionar todas correspondentes" em lote. A resposta carrega o total filtrado e um flag truncado; o cliente fragmenta os ids retornados nas chamadas de ação em lote limitadas. Sem paginação/classificação: retorna o conjunto filtrado inteiro (limitado). operationId: selectExceptionIDs parameters: - description: >- Filter by reconciliation context ID (UUID, verified against the tenant; 404 when unknown) explode: false in: query name: contextId schema: description: >- Filtrar por ID do contexto de reconciliação (UUID, verificado contra o tenant; 404 quando desconhecido) examples: - 550e8400-e29b-41d4-a716-446655440000 format: uuid type: string - description: Filter by status explode: false in: query name: status schema: description: Filtrar por status enum: - OPEN - ASSIGNED - RESOLVED type: string - description: Filter by severity explode: false in: query name: severity schema: description: Filtrar por severidade enum: - LOW - MEDIUM - HIGH - CRITICAL type: string - description: Filter by exception reason explode: false in: query name: reason schema: description: Filtrar por motivo da exceção enum: - 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 type: string - description: Filter by assigned user explode: false in: query name: assigned_to schema: description: Filtrar por usuário atribuído examples: - user@example.com type: string - description: Filter by external system explode: false in: query name: external_system schema: description: Filtrar por sistema externo examples: - JIRA type: string - description: >- Free-text search across transaction id, reason, and external issue id (case-insensitive substring match) explode: false in: query name: search schema: description: >- 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) examples: - null type: string - description: >- 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 explode: false in: query name: date_from schema: description: >- 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 examples: - '2025-01-01T00:00:00Z' type: string - description: >- 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 explode: false in: query name: date_to schema: description: >- 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 examples: - '2025-01-31T23:59:59Z' type: string - description: >- Filter to exceptions at least this many days old (by created_at). 0 (default) disables the filter. explode: false in: query name: min_age_days schema: description: >- Filtrar para exceções com pelo menos esta quantidade de dias (por created_at). 0 (padrão) desativa o filtro. examples: - 30 format: int64 maximum: 3650 minimum: 0 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/SelectExceptionIDsResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Erro security: - BearerAuth: [] components: schemas: SelectExceptionIDsResponse: additionalProperties: false properties: ids: description: >- IDs de exceção que correspondem ao filtro, ordenados deterministicamente (created_at DESC, id DESC), limitados a 10000 items: type: string maxItems: 10000 type: - array - 'null' total: description: >- Total de exceções que correspondem ao filtro (conjunto completo; pode exceder os IDs retornados) examples: - 530 format: int64 type: integer truncated: description: >- Verdadeiro quando o conjunto filtrado excede os IDs retornados (o limite foi atingido); uma única passagem em lote não cobrirá toda correspondência examples: - false type: boolean required: - ids - total - truncated type: object Detail: additionalProperties: false properties: code: description: >- Código de erro de domínio estável e legível por máquina com escopo no serviço emissor (formato: -NNNN). examples: - ERR-0001 type: string detail: description: >- Uma explicação legível por humanos específica para esta ocorrência do problema. examples: - Property foo is required but is missing. type: string errors: description: Lista opcional de detalhes de erro individuais items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- Uma referência URI que identifica a ocorrência específica do problema. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: Código de status HTTP examples: - 400 format: int64 type: integer title: description: >- Um resumo curto e legível por humanos do tipo do problema. Este valor não deve mudar entre ocorrências do erro. examples: - Bad Request type: string type: default: about:blank description: >- Uma referência URI para documentação legível por humanos sobre o erro. examples: - https://example.com/errors/example format: uri type: string type: object ErrorDetail: additionalProperties: false properties: location: description: 'Onde o erro ocorreu, ex.: ''body.items[3].tags'' ou ''path.thing-id''' type: string message: description: Texto da mensagem de erro type: string value: description: O valor na localização informada type: object securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Autenticação por Bearer token (formato: "Bearer {token}")' ````