> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qa.esectra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Handles
`GET /v1/control/verification-sessions/{session_id}/evidence/{kind}/preview`.

> # Errors

Returns `401` without a session, `403` for an API key or a role without
`VERIFICATIONS_READ`, `404` for a session this tenant does not have, a
kind that is not `selfie` or `document`, evidence that was never
submitted or a page it does not have, `409` while the session is being
evaluated, `410` for evidence that is expired or purged, `422` when no safe preview can be made, and `503` when the
converter, a store or the audit trail cannot be reached.



## OpenAPI

````yaml /openapi.json get /v1/control/verification-sessions/{session_id}/evidence/{kind}/preview
openapi: 3.1.0
info:
  title: Esectra API
  description: >-
    Transaction screening, identity verification, and wallet risk.


    Every create route accepts `Idempotency-Key`; replaying one returns the
    original record with `200` where the first call returned `201`. `POST
    /v1/transactions` requires the header, because a duplicated transaction is a
    duplicated financial record.
  license:
    name: proprietary
    identifier: proprietary
  version: 0.1.0
servers: []
security: []
paths:
  /v1/control/verification-sessions/{session_id}/evidence/{kind}/preview:
    get:
      tags:
        - Control
      summary: >-
        Handles

        `GET
        /v1/control/verification-sessions/{session_id}/evidence/{kind}/preview`.
      description: >-
        # Errors


        Returns `401` without a session, `403` for an API key or a role without

        `VERIFICATIONS_READ`, `404` for a session this tenant does not have, a

        kind that is not `selfie` or `document`, evidence that was never

        submitted or a page it does not have, `409` while the session is being

        evaluated, `410` for evidence that is expired or purged, `422` when no
        safe preview can be made, and `503` when the

        converter, a store or the audit trail cannot be reached.
      operationId: session_preview_handler
      parameters:
        - name: session_id
          in: path
          description: The session id
          required: true
          schema:
            type: string
        - name: kind
          in: path
          description: '`selfie` or `document`'
          required: true
          schema:
            type: string
        - name: page
          in: query
          description: The page, counting from one. One when omitted.
          required: false
          schema:
            type:
              - integer
              - 'null'
            format: int32
            minimum: 0
      responses:
        '200':
          description: >-
            One page as a bounded JPEG, never the original upload. Recorded in
            the audit trail.
          content:
            image/jpeg:
              schema:
                type: array
                items:
                  type: integer
                  format: int32
                  minimum: 0
        '401':
          description: No usable credentials
        '403':
          description: An API key, or a role without VERIFICATIONS_READ
        '404':
          description: No such session, kind, evidence or page
        '409':
          description: >-
            The verification is being evaluated; its evidence cannot be viewed
            until that has finished
        '410':
          description: The evidence is expired or was purged
        '422':
          description: No safe preview can be made from this evidence
        '503':
          description: The converter, a store or the audit trail could not be reached
      security:
        - session_cookie: []
components:
  securitySchemes:
    session_cookie:
      type: apiKey
      in: cookie
      name: esectra_session
      description: >-
        A signed-in reviewer's session. httpOnly and SameSite=Lax; set by `POST
        /v1/control/sessions` and only usable once the second factor is met.

````

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