> ## 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. # Obter uma única revisão de extração de IA > Retorna uma revisão de extração com seus candidatos, proveniência e ciclo de vida. Tenant do JWT, contexto do path. ## OpenAPI ````yaml pt/openapi/v3-current/matcher.yaml get /v1/imports/contexts/{contextId}/extraction-reviews/{reviewId} 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/imports/contexts/{contextId}/extraction-reviews/{reviewId}: get: tags: - Ingestion summary: Obter uma única revisão de extração de IA description: >- Retorna uma revisão de extração com seus candidatos, proveniência e ciclo de vida. Tenant do JWT, contexto do path. operationId: getExtractionReview parameters: - description: Context ID in: path name: contextId required: true schema: description: ID do contexto format: uuid type: string - description: Review ID in: path name: reviewId required: true schema: description: ID da revisão format: uuid type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExtractionReviewResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Erro security: - BearerAuth: [] components: schemas: ExtractionReviewResponse: additionalProperties: false properties: candidates: description: Candidatos a transação propostos aguardando revisão items: $ref: '#/components/schemas/CandidateResponse' type: - array - 'null' contextId: description: Contexto de reconciliação ao qual os candidatos pertencem examples: - 550e8400-e29b-41d4-a716-446655440000 format: uuid type: string createdAt: description: Timestamp de criação (RFC 3339, UTC) examples: - '2025-01-15T10:30:00Z' format: date-time type: string id: description: Identificador da revisão examples: - 550e8400-e29b-41d4-a716-446655440000 format: uuid type: string ingestionJobId: description: >- Job de ingestão downstream vinculado na aprovação; null até ser vinculado examples: - 550e8400-e29b-41d4-a716-446655440000 format: uuid type: string rejectReason: description: Motivo em texto livre capturado na rejeição; vazio caso contrário type: string reviewerId: description: >- ID do principal do humano que adjudicou a revisão; vazio até ser decidida type: string sourceId: description: Origem de reconciliação à qual os candidatos pertencem examples: - 550e8400-e29b-41d4-a716-446655440000 format: uuid type: string status: description: >- Ciclo de vida da revisão: PENDING_REVIEW (aguardando decisão), APPROVED (candidatos ingeridos), REJECTED (descartada) examples: - PENDING_REVIEW type: string updatedAt: description: Timestamp da última atualização (RFC 3339, UTC) examples: - '2025-01-15T10:35:00Z' format: date-time type: string version: description: >- Versão de concorrência otimista, incrementada a cada mudança de estado examples: - 1 format: int64 type: integer required: - id - contextId - sourceId - status - candidates - version - createdAt - updatedAt 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 CandidateResponse: additionalProperties: false properties: fields: description: Detalhamento por campo com tokens literais, confiança e proveniência items: $ref: '#/components/schemas/CandidateFieldResponse' type: - array - 'null' source: description: >- Lane de extração que produziu este candidato: text_layer (texto de PDF, maior confiança) ou vision (modelo de OCR/visão, menor confiança) examples: - text_layer type: string required: - source - fields 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 CandidateFieldResponse: additionalProperties: false properties: canonicalKey: description: >- Chave canônica de mapa de campo (ex.: amount, external_id, currency, date) examples: - amount type: string confidence: description: Confiança do extrator neste campo, de 0.0 (nenhuma) a 1.0 (certa) examples: - 0.95 format: double maximum: 1 minimum: 0 type: number page: description: Página (base 1) de onde o valor foi extraído; 0 quando desconhecido examples: - 1 format: int64 type: integer region: description: >- Descritor de região/bounding-box de melhor esforço; vazio quando a lane de origem não o expõe type: string value: description: >- Token de string literal extraído para a chave canônica; dinheiro permanece uma string, nunca um valor parseado examples: - '100.50' type: string required: - canonicalKey - value - confidence - page type: object securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Autenticação por Bearer token (formato: "Bearer {token}")' ````