> ## 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.

# Seleccionar ids de excepción por filtro

> Resuelve los ids de cada excepción que coincide con el MISMO filtro que GET /v1/exceptions (status, severity, contextId, reason, assigned_to, external_system, search, date_from, date_to, min_age_days), hasta un tope de 10000, para la ruta masiva de "seleccionar todo lo coincidente". La respuesta lleva el total filtrado y una bandera de truncamiento; el cliente divide los ids devueltos en las llamadas de acción masiva limitadas. Sin paginación/orden: devuelve todo el conjunto filtrado (limitado).



## OpenAPI

````yaml es/openapi/v3-current/matcher.yaml get /v1/exceptions/ids
openapi: 3.1.0
info:
  title: Matcher APIs
  description: >-
    Referencia completa de la API para el motor de conciliación Matcher, que
    proporciona conciliación automatizada de transacciones entre Midaz Ledger y
    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: Seleccionar ids de excepción por filtro
      description: >-
        Resuelve los ids de cada excepción que coincide con el MISMO filtro que
        GET /v1/exceptions (status, severity, contextId, reason, assigned_to,
        external_system, search, date_from, date_to, min_age_days), hasta un
        tope de 10000, para la ruta masiva de "seleccionar todo lo coincidente".
        La respuesta lleva el total filtrado y una bandera de truncamiento; el
        cliente divide los ids devueltos en las llamadas de acción masiva
        limitadas. Sin paginación/orden: devuelve todo el conjunto filtrado
        (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 de contexto de reconciliación (UUID, verificado
              contra el tenant; 404 cuando es desconocido)
            examples:
              - 550e8400-e29b-41d4-a716-446655440000
            format: uuid
            type: string
        - description: Filter by status
          explode: false
          in: query
          name: status
          schema:
            description: Filtrar por estado
            enum:
              - OPEN
              - ASSIGNED
              - RESOLVED
            type: string
        - description: Filter by severity
          explode: false
          in: query
          name: severity
          schema:
            description: Filtrar por severidad
            enum:
              - LOW
              - MEDIUM
              - HIGH
              - CRITICAL
            type: string
        - description: Filter by exception reason
          explode: false
          in: query
          name: reason
          schema:
            description: Filtrar por motivo de excepción
            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 usuario asignado
            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: >-
              Búsqueda de texto libre en id de transacción, motivo e id de
              incidencia externa (coincidencia de subcadena sin distinción de
              mayú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 desde fecha, límite inferior inclusivo. Acepta una marca
              de tiempo RFC 3339 o una fecha simple (YYYY-MM-DD); una fecha
              simple se toma a las 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 hasta fecha, límite superior inclusivo. Acepta una marca
              de tiempo RFC 3339 o una fecha simple (YYYY-MM-DD); una fecha
              simple cubre todo el día hasta las 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 a excepciones de al menos esta antigüedad en días (por
              created_at). 0 (predeterminado) desactiva el 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: Error
      security:
        - BearerAuth: []
components:
  schemas:
    SelectExceptionIDsResponse:
      additionalProperties: false
      properties:
        ids:
          description: >-
            ids de excepción que coinciden con el filtro, ordenados de forma
            determinista (created_at DESC, id DESC), limitados a 10000
          items:
            type: string
          maxItems: 10000
          type:
            - array
            - 'null'
        total:
          description: >-
            Total de excepciones que coinciden con el filtro (conjunto completo;
            puede exceder los ids devueltos)
          examples:
            - 530
          format: int64
          type: integer
        truncated:
          description: >-
            Verdadero cuando el conjunto filtrado excede los ids devueltos (se
            alcanzó el tope); una sola pasada masiva no cubrirá cada
            coincidencia
          examples:
            - false
          type: boolean
      required:
        - ids
        - total
        - truncated
      type: object
    Detail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Código de error de dominio estable y legible por máquina con alcance
            al servicio emisor (formato: <SERVICE>-NNNN).
          examples:
            - ERR-0001
          type: string
        detail:
          description: >-
            Una explicación legible por humanos específica de esta ocurrencia
            del problema.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Lista opcional de detalles de errores individuales
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            Una referencia URI que identifica la ocurrencia específica del
            problema.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: Código de estado HTTP
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            Un resumen breve y legible por humanos del tipo de problema. Este
            valor no debería cambiar entre ocurrencias del error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: >-
            Una referencia URI a documentación legible por humanos para el
            error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Dónde ocurrió el error, p. ej. 'body.items[3].tags' o
            'path.thing-id'
          type: string
        message:
          description: Texto del mensaje de error
          type: string
        value:
          description: El valor en la ubicación indicada
      type: object
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Autenticación con token Bearer (formato: "Bearer {token}")'

````