> ## 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. # Listar sugerencias de reglas de coincidencia de IA (la cola de revisión humana) > Lista paginada por cursor de sugerencias de reglas para un contexto, opcionalmente filtrada por estado (p. ej. PENDING_REVIEW). Lee candidatos almacenados solo de configuración; no egresa nada. Tenant desde el JWT, contexto desde la ruta. ## OpenAPI ````yaml es/openapi/v3-current/matcher.yaml get /v1/matching/contexts/{contextId}/rule-suggestions 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/matching/contexts/{contextId}/rule-suggestions: get: tags: - Matching summary: >- Listar sugerencias de reglas de coincidencia de IA (la cola de revisión humana) description: >- Lista paginada por cursor de sugerencias de reglas para un contexto, opcionalmente filtrada por estado (p. ej. PENDING_REVIEW). Lee candidatos almacenados solo de configuración; no egresa nada. Tenant desde el JWT, contexto desde la ruta. operationId: listMatchRuleSuggestions parameters: - description: Context ID in: path name: contextId required: true schema: description: ID del contexto format: uuid type: string - description: Filter by status explode: false in: query name: status schema: description: Filtrar por estado enum: - PENDING_REVIEW - APPROVED - REJECTED type: string - description: Page size explode: false in: query name: limit schema: description: Tamaño de página format: int64 maximum: 200 minimum: 1 type: integer - description: Opaque pagination cursor explode: false in: query name: cursor schema: description: Cursor de paginación opaco type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/RuleSuggestionListResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: RuleSuggestionListResponse: additionalProperties: false properties: items: description: Página de revisiones de sugerencias de reglas items: $ref: '#/components/schemas/RuleSuggestionResponse' type: - array - 'null' limit: description: Número máximo de ítems solicitados para esta página examples: - 20 format: int64 type: integer nextCursor: description: >- Cursor opaco para la página siguiente; vacío cuando no hay más resultados examples: - eyJpZCI6IjEyMyJ9 type: string prevCursor: description: Cursor opaco para la página anterior; vacío en la primera página examples: - eyJpZCI6IjEyMiJ9 type: string required: - items - limit 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: -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 RuleSuggestionResponse: additionalProperties: false properties: candidate: $ref: '#/components/schemas/RuleSuggestionCandidateResponse' description: La regla de coincidencia propuesta, solo de configuración contextId: description: ID del contexto de reconciliación al que pertenece esta sugerencia examples: - 550e8400-e29b-41d4-a716-446655440000 type: string createdAt: description: Cuándo se creó la revisión (RFC 3339) examples: - '2026-06-16T10:30:00Z' type: string createdRuleId: description: >- Identificador de la regla de coincidencia creada en la aprobación; vacío hasta que se vincula una revisión aprobada examples: - 550e8400-e29b-41d4-a716-446655440000 type: string id: description: Identificador único de la revisión examples: - 550e8400-e29b-41d4-a716-446655440000 type: string rejectReason: description: Motivo opcional registrado cuando se rechaza la sugerencia examples: - too aggressive type: string reviewerId: description: >- ID de principal del revisor; vacío hasta que se adjudica la sugerencia examples: - user-42 type: string status: description: >- Estado del ciclo de vida: PENDING_REVIEW (a la espera de decisión humana), APPROVED (regla creada) o REJECTED (descartada) examples: - PENDING_REVIEW type: string updatedAt: description: Cuándo se actualizó la revisión por última vez (RFC 3339) examples: - '2026-06-16T10:35:00Z' type: string version: description: Versión de concurrencia optimista de la revisión examples: - 1 format: int64 type: integer required: - id - contextId - candidate - status - version - createdAt - updatedAt 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 RuleSuggestionCandidateResponse: additionalProperties: false properties: confidence: description: >- Confianza del asesor en la sugerencia, de 0.0 (más baja) a 1.0 (más alta) examples: - 0.82 format: double type: number config: additionalProperties: {} description: >- Configuración de regla por tipo sobre el esquema cerrado; la forma depende del tipo de candidato type: object expectedImprovement: description: >- Nota informativa sobre el efecto esperado en la tasa de auto-coincidencia; nunca una cifra monetaria examples: - +8% auto-match type: string priority: description: >- Prioridad de regla propuesta en el rango 1..1000 (menor se ejecuta primero) examples: - 10 format: int64 type: integer rationale: description: Justificación breve y legible por humanos de la sugerencia examples: - near-miss amounts cluster under 1% type: string type: description: >- Tipo de regla propuesto del vocabulario cerrado: EXACT (igualdad estricta), TOLERANCE (dentro de una banda de importe) o DATE_LAG (que permite un offset de fecha de liquidación) examples: - TOLERANCE type: string required: - type - priority - config - rationale - confidence type: object securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Autenticación con token Bearer (formato: "Bearer {token}")' ````