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

# Retrieve parsed document

> The endpoint returns a parsed document with its extracted data. The `parsed_data` field contains structured information extracted from the document.
**Note:** Currently, only volunteer letters are available through this endpoint.
For volunteer letters, the `parsed_data` includes volunteer information such as total hours, dates (start_date, end_date), position title, and optionally detailed hour entries with dates, hours, and descriptions for each volunteer activity.




## OpenAPI

````yaml GET /v1/links/{link_id}/parsed-documents/{doc_id}/
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/{doc_id}/:
    parameters:
      - name: link_id
        in: path
        description: Link ID
        required: true
        schema:
          type: string
        example: 24d7e80942ce4ad58a93f70ce4115f5c
      - name: doc_id
        in: path
        description: Parsed Document ID
        required: true
        schema:
          type: string
        example: 24d7e80942ce4ad58a93f70ce4115f5c
    get:
      tags:
        - Parsed Documents
      summary: Retrieve parsed document
      description: >
        The endpoint returns a parsed document with its extracted data. The
        `parsed_data` field contains structured information extracted from the
        document.

        **Note:** Currently, only volunteer letters are available through this
        endpoint.

        For volunteer letters, the `parsed_data` includes volunteer information
        such as total hours, dates (start_date, end_date), position title, and
        optionally detailed hour entries with dates, hours, and descriptions for
        each volunteer activity.
      operationId: retrieve-parsed-document
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ParsedDocumentRetrieve'
        '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'
        '404':
          description: HTTP 404 Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
components:
  schemas:
    ParsedDocumentRetrieve:
      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
        parsed_data:
          title: parsed_data
          description: >
            Parsed document data extracted from the volunteer letter. Currently,
            only volunteer letters are supported.


            For volunteer letters, this includes:

            - `total_hours`: Total volunteer hours (number)

            - `time_entries`: (Optional) Detailed breakdown of volunteer hours.
            Array of objects, each containing:
              - `date`: Date of volunteer activity (YYYY-MM-DD)
              - `hours`: Hours worked on that date (number)
              - `description`: Description of the volunteer activity (string)


            The structure depends on the document subtype:

            - **VOL_TRANSCRIPT**: Contains summary fields (total_hours)

            - **VOL_HOURS_LOG**: Contains both summary (total_hours) and
            detailed time_entries array
          type: object
          readOnly: true
          nullable: true
          example:
            total_hours: 89.6
            time_entries:
              - date: '2025-01-29'
                hours: 5.1
                description: Facilitated group activities and sessions
              - date: '2025-02-02'
                hours: 5
                description: Assisted with data entry and record keeping
              - date: '2025-02-05'
                hours: 5.8
                description: Participated in community cleanup and maintenance
              - date: '2025-02-07'
                hours: 3.4
                description: Assisted with food distribution to local families
              - date: '2025-02-16'
                hours: 5.6
                description: Led educational workshops for participants
    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.
    Error404:
      description: ''
      type: object
      properties:
        detail:
          description: ''
          type: string
          example: Not Found.
  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

````