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

# List all parsed documents

> The endpoint returns a list of parsed documents. Parsed documents contain structured data extracted from uploaded documents.
**Note:** Currently, only volunteer letters are available through this endpoint. Support for additional document types (paystubs, etc.) will be added in future releases.
You can filter, order, and paginate results using query parameters.




## OpenAPI

````yaml GET /v1/links/{link_id}/parsed-documents/
openapi: 3.0.1
info:
  title: Truv API
  description: Truv API Documentation
  termsOfService: https://www.truv.com/legal/terms-of-use
  contact:
    email: support@truv.com
  version: v1
servers:
  - url: https://prod.truv.com
security:
  - ClientID: []
    AccessKey: []
tags:
  - name: Users
  - name: Bridge Token
  - name: Companies and Data Providers
  - name: Key Management
  - name: Account Links
  - name: Data Refresh
  - name: Customization Templates
  - name: Webhooks
  - name: Orders
  - name: Tasks
  - name: VOIE Reports
  - name: VOA Reports
  - name: Income Insights Reports
  - name: DDS Reports
  - name: Employment
  - name: Identity
  - name: Shifts
  - name: Pay Statements
  - name: Tax Documents
  - name: Parsed Documents
  - name: Reports
  - name: Uploaded Documents
  - name: Bank Accounts
  - name: Bank Statements
  - name: Deposit Switch Reports
  - name: Insurance Reports
  - name: Income Report
  - name: Scoring Attributes
  - name: Accounts
  - name: Transactions
  - name: Recurring Transactions
  - name: Document Collections
paths:
  /v1/links/{link_id}/parsed-documents/:
    parameters:
      - name: link_id
        in: path
        description: Link ID
        required: true
        schema:
          type: string
        example: 24d7e80942ce4ad58a93f70ce4115f5c
    get:
      tags:
        - Parsed Documents
      summary: List all parsed documents
      description: >
        The endpoint returns a list of parsed documents. Parsed documents
        contain structured data extracted from uploaded documents.

        **Note:** Currently, only volunteer letters are available through this
        endpoint. Support for additional document types (paystubs, etc.) will be
        added in future releases.

        You can filter, order, and paginate results using query parameters.
      operationId: list-parsed-documents
      parameters:
        - name: document_type
          in: query
          description: >-
            Filter by document type. Currently only 'VOLUNTEER_LETTER' is
            supported.
          required: false
          schema:
            type: string
            example: VOLUNTEER_LETTER
            enum:
              - VOLUNTEER_LETTER
          example: VOLUNTEER_LETTER
        - name: document_subtype
          in: query
          description: >-
            Filter by document subtype. For volunteer letters use VOL_TRANSCRIPT
            or VOL_HOURS_LOG.
          required: false
          schema:
            type: string
            example: VOL_TRANSCRIPT
            enum:
              - VOL_TRANSCRIPT
              - VOL_HOURS_LOG
          example: VOL_TRANSCRIPT
        - name: ordering
          in: query
          description: Order results by field. Prefix with '-' for descending order.
          required: false
          schema:
            type: string
            enum:
              - created_at
              - '-created_at'
            default: '-created_at'
        - name: page
          in: query
          description: Page number for pagination
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: page_size
          in: query
          description: Number of results per page
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 10
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                required:
                  - count
                  - results
                type: object
                properties:
                  count:
                    type: integer
                    description: Total number of parsed documents
                    example: 42
                  next:
                    type: string
                    format: uri
                    nullable: true
                    description: URL to next page
                    example: >-
                      https://prod.truv.com/v1/links/{link_id}/parsed-documents/?page=2
                  previous:
                    type: string
                    format: uri
                    nullable: true
                    description: URL to previous page
                    example: null
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/ParsedDocument'
        '401':
          description: HTTP 401 Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error401'
        '403':
          description: HTTP 403 Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
components:
  schemas:
    ParsedDocument:
      required:
        - document_type
      type: object
      properties:
        id:
          title: id
          description: Parsed document ID
          type: string
          readOnly: true
          example: 24d7e80942ce4ad58a93f70ce4115f5c
        document_type:
          title: document_type
          description: Document type. Currently only 'VOLUNTEER_LETTER' is supported.
          type: string
          enum:
            - VOLUNTEER_LETTER
          readOnly: true
          example: VOLUNTEER_LETTER
        document_subtype:
          title: document_subtype
          description: Document subtype
          type: string
          enum:
            - VOL_TRANSCRIPT
            - VOL_HOURS_LOG
            - null
          readOnly: true
          nullable: true
          example: VOL_TRANSCRIPT
        file:
          title: file
          description: Parsed document file link
          type: string
          format: uri
          readOnly: true
          nullable: true
          example: https://cdn.truv.com/files_examples/VOLUNTEER_LETTER.pdf
        md5sum:
          title: md5sum
          description: Parsed document md5sum
          type: string
          readOnly: true
          example: 24d7e80942ce4ad58a93f70ce4115f5c
    Error401:
      description: ''
      type: object
      properties:
        error:
          description: ''
          type: object
          properties:
            code:
              description: ''
              type: string
              example: authentication_failed
            message:
              description: ''
              type: string
              example: No such token
    Error403:
      description: ''
      type: object
      properties:
        error:
          description: ''
          type: object
          properties:
            code:
              description: ''
              type: string
              example: not_authenticated
            message:
              description: ''
              type: string
              example: Authentication credentials were not provided.
  securitySchemes:
    ClientID:
      type: apiKey
      description: Client ID
      name: X-Access-Client-Id
      in: header
    AccessKey:
      type: apiKey
      description: Client Access Key
      name: X-Access-Secret
      in: header

````