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

# Retrieve a consultation's evidence trail

> Returns the evidence trail of one consultation: every record, in ascending `sequence` order. This order reconstructs the history of the consultation.

An unknown or malformed id returns `404` with code `SRC-0301`. A trail too large for one response returns `422` with code `SRC-0002`.



## OpenAPI

````yaml /es/openapi/v3-current/src.yaml get /v1/src/evidence/consultations/{id}
openapi: 3.1.0
info:
  description: >-
    API for Lerian SRC, which sends your institution's restriction consultations
    to BACEN's BC Protege+ and keeps the evidence of each consultation.
  title: Lerian SRC API
  version: 1.0.0
servers:
  - url: https://api.example.com
    description: Replace the example host with your deployment's address.
security:
  - m2m: []
tags:
  - description: >-
      Asynchronous restriction consultations (accept → pending →
      completed/failed).
    name: consultation
  - description: >-
      Client-decision records (exceptional proceed, refusal explanation) —
      single-purpose, write-once.
    name: decision
  - description: Regulatory evidence trail — search, reconstruction, chained correction.
    name: evidence
  - description: Aggregated numeric view per institution.
    name: dashboard
  - description: Status of the institution's regulatory credential.
    name: credential
  - description: >-
      Operator cases — the backlog `openOperatorCases` counts, and the act that
      closes one.
    name: operator
paths:
  /v1/src/evidence/consultations/{id}:
    get:
      tags:
        - evidence
      summary: Retrieve a consultation's evidence trail
      description: >-
        Returns the evidence trail of one consultation: every record, in
        ascending `sequence` order. This order reconstructs the history of the
        consultation.


        An unknown or malformed id returns `404` with code `SRC-0301`. A trail
        too large for one response returns `422` with code `SRC-0002`.
      operationId: getEvidenceTrail
      parameters:
        - description: >-
            Consultation identifier (UUID). An identifier that is unknown or
            malformed returns 404 SRC-0301.
          in: path
          name: id
          required: true
          schema:
            description: >-
              Consultation identifier (UUID). An identifier that is unknown or
              malformed returns 404 SRC-0301.
            examples:
              - 0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a
            type: string
        - description: Optional correlation id (UUID) propagated through logs/traces.
          in: header
          name: X-Request-ID
          schema:
            description: Optional correlation id (UUID) propagated through logs/traces.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvidenceTrailBody'
          description: OK
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Unauthorized
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Forbidden
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Not Found
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Unprocessable Entity
        '429':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Too Many Requests
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: Internal Server Error
      security:
        - m2m:
            - src:evidence:read
components:
  schemas:
    EvidenceTrailBody:
      additionalProperties: false
      properties:
        consultationId:
          description: Consultation the trail belongs to.
          examples:
            - 0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a
          type: string
        records:
          description: >-
            The complete history in ascending sequence. Never empty: a
            consultation with no records is a 404.
          items:
            $ref: '#/components/schemas/EvidenceRecordBody'
          type:
            - array
            - 'null'
      required:
        - consultationId
        - records
      type: object
    ProblemDetails:
      additionalProperties: false
      properties:
        code:
          type: string
        correlationId:
          examples:
            - req-7a3f9c2e
          type: string
        detail:
          examples:
            - check digits are invalid for the declared documentType
          type: string
        details:
          additionalProperties: {}
          type: object
        instance:
          examples:
            - /v1/src/consultations
          type: string
        status:
          examples:
            - 400
          format: int64
          type: integer
        title:
          examples:
            - Bad Request
          type: string
        traceId:
          examples:
            - a1b2c3d4
          type: string
        type:
          type: string
        violations:
          items:
            $ref: '#/components/schemas/Violation'
          type:
            - array
            - 'null'
      required:
        - type
        - title
        - status
        - detail
        - instance
        - traceId
        - correlationId
        - violations
      type: object
    EvidenceRecordBody:
      additionalProperties: false
      properties:
        correctsSequence:
          description: >-
            For kind=correction, the sequence of the corrected record. The
            original remains in the trail — corrections chain, they never
            overwrite.
          format: int64
          type: integer
        data:
          additionalProperties: {}
          description: Record content; its members vary per kind.
          type: object
        kind:
          description: Record class.
          enum:
            - acceptance
            - entry_refusal
            - dispatch_attempt
            - channel_confirmation
            - response
            - rejection
            - duplicate_response
            - notification
            - client_decision
            - refusal_explanation
            - credential_operation
            - operator_case_closure
            - correction
          examples:
            - acceptance
          type: string
        occurredAt:
          description: >-
            When the recorded FACT happened (RFC3339). It is not the write time
            and it is not the order.
          format: date-time
          type: string
        sequence:
          description: >-
            Position in the trail, starting at 1. The trail is served in
            ascending sequence, which is the reconstruction order — NOT
            occurredAt, which is when the recorded fact happened and can be
            earlier for a fact recorded on a later attempt.
          examples:
            - 1
          format: int64
          type: integer
      required:
        - sequence
        - kind
        - occurredAt
      type: object
    Violation:
      additionalProperties: false
      properties:
        code:
          type: string
        field:
          examples:
            - document
          type: string
        reason:
          examples:
            - check digits are invalid for the declared documentType
          type: string
      required:
        - field
        - reason
      type: object
  securitySchemes:
    m2m:
      flows:
        clientCredentials:
          scopes:
            src:consultation:read: Read/list consultations
            src:consultation:write: Create restriction consultations
            src:credential:read: Read regulatory-credential status
            src:dashboard:read: Read the aggregated numeric dashboard
            src:decision:write: >-
              File the institution's record against a consultation — exceptional
              proceed (§1º) or refusal explanation (§2º)
            src:evidence:correct: Append a chained correction to an evidence trail
            src:evidence:read: Search and reconstruct the evidence trail
            src:operator:close: >-
              Close an open operator case so it leaves the openOperatorCases
              backlog
            src:operator:read: List the operator cases
          tokenUrl: https://access-manager.example.com/oauth2/token
      type: oauth2

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.