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

# List a verification's documents

> Return the documents collected for this verification; use the download endpoint to fetch one.



## OpenAPI

````yaml /api-reference/openapi.json get /verifications/{verification_id}/documents
openapi: 3.1.0
info:
  title: Verify with Privue
  description: >-
    Verify your users' identity and business details through Privue's hosted
    flow.


    **Authentication.** Every request takes your API key as a bearer token:
    `Authorization: Bearer <your-key>`.


    **Flow.**


    1. `POST /verifications` with the user's phone. We start their verification
    session and return a `verification_id`.

    2. Redirect the user to `https://verify.privue.ai/<your-slug>` to complete
    the steps.

    3. Poll `GET /verifications/{verification_id}` for status and step progress,
    and `GET /verifications/{verification_id}/data` for the collected result.

    4. Optionally `POST /verifications/{verification_id}/cancel` to end a
    verification early.


    **Identifiers.** `verification_id` is ours and names the verification on
    every read. `reference_id` is your own optional correlation id - stored and
    echoed back, never used as a key.


    **Timestamps.** Timestamps are in IST.


    **Polling.** Reads are free and safe to poll as often as you need.
  version: 0.1.0
servers:
  - url: https://api.verify.privue.ai
    description: Production
security: []
paths:
  /verifications/{verification_id}/documents:
    get:
      tags:
        - Verifications
      summary: List a verification's documents
      description: >-
        Return the documents collected for this verification; use the download
        endpoint to fetch one.
      operationId: list_documents_verifications__verification_id__documents_get
      parameters:
        - name: verification_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Verification Id
      responses:
        '200':
          description: Metadata for every document the user uploaded.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/DocumentPublic'
                title: >-
                  Response List Documents Verifications  Verification Id 
                  Documents Get
              example:
                - document_id: b0f3e1c2-5a8d-4e77-9f21-3d4c6a2b1e90
                  tag: gst_certificate
                  kind: document
                  filename: gst-certificate.pdf
                  content_type: application/pdf
                  size_bytes: 184320
                  uploaded_at: '2026-08-06T14:39:20'
                - document_id: 7c1d90a4-2e6b-4f38-8a11-9b5f0c7d2e41
                  tag: pan_card
                  kind: image
                  filename: pan-card.jpg
                  content_type: image/jpeg
                  size_bytes: 96117
                  uploaded_at: '2026-08-06T14:39:48'
                - document_id: e5a2f7b9-3c40-4d1a-b6e8-1f2c3d4a5b60
                  tag: bank_statement
                  kind: document
                  filename: bank-statement.pdf
                  content_type: application/pdf
                  size_bytes: 251904
                  uploaded_at: '2026-08-06T14:40:12'
        '401':
          description: Missing, malformed, or rejected API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: API key is missing, malformed, or rejected.
        '403':
          description: The API key is valid but not enrolled as a verification client.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: No active verification client for this API key.
        '404':
          description: No verification with that verification_id for this client.
          content:
            application/json:
              example:
                detail: No verification with id 3f2504e0-4f89-41d3-9a0c-0305e82c3301.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    DocumentPublic:
      properties:
        document_id:
          type: string
          format: uuid
          title: Document Id
        tag:
          type: string
          title: Tag
          description: Which step or slot the user uploaded this document against
        kind:
          $ref: '#/components/schemas/DocumentKind'
        filename:
          type: string
          title: Filename
        content_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Content Type
        size_bytes:
          anyOf:
            - type: integer
            - type: 'null'
          title: Size Bytes
        uploaded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Uploaded At
      type: object
      required:
        - document_id
        - tag
        - kind
        - filename
        - content_type
        - size_bytes
        - uploaded_at
      title: DocumentPublic
      description: One document the user uploaded.
    ErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: A human-readable explanation of what went wrong
      type: object
      required:
        - detail
      title: ErrorResponse
      description: >-
        Every error on this API returns this shape. Branch on the HTTP status,
        not the message text.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DocumentKind:
      type: string
      enum:
        - document
        - image
      title: DocumentKind
      description: Whether an uploaded file is a document or an image.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````