> ## 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 benefit letters > The endpoint returns the benefit letters of a link, such as the veteran's VA Benefit Verification letter. Each item names the letter and links to the file it was read from; retrieve a letter to get the values read from it. A refresh fetches a new letter, so a link can hold more than one. The list is ordered by the pay date of the statement each letter was fetched with, newest first, so the first item is the most recent letter. Re-reading an older letter does not move it ahead. `document_type` says which letter an item is and so which shape its `fields` take on retrieve. Only `VA_BENEFIT_LETTER` letters are returned today; `SSA_BENEFIT_LETTER` is reserved for the Social Security benefit letter. Returns an empty array when the link has no benefit letter, including for a VA link whose letter has not been parsed yet. ## OpenAPI ````yaml GET /v1/links/{link_id}/benefit_letters/ 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: Benefit Letters - 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 - name: Sandbox paths: /v1/links/{link_id}/benefit_letters/: parameters: - name: link_id in: path description: Link ID required: true schema: type: string example: 24d7e80942ce4ad58a93f70ce4115f5c get: tags: - Benefit Letters summary: List all benefit letters description: >- The endpoint returns the benefit letters of a link, such as the veteran's VA Benefit Verification letter. Each item names the letter and links to the file it was read from; retrieve a letter to get the values read from it. A refresh fetches a new letter, so a link can hold more than one. The list is ordered by the pay date of the statement each letter was fetched with, newest first, so the first item is the most recent letter. Re-reading an older letter does not move it ahead. `document_type` says which letter an item is and so which shape its `fields` take on retrieve. Only `VA_BENEFIT_LETTER` letters are returned today; `SSA_BENEFIT_LETTER` is reserved for the Social Security benefit letter. Returns an empty array when the link has no benefit letter, including for a VA link whose letter has not been parsed yet. operationId: benefit-letters responses: '200': description: '' content: application/json: schema: type: array items: $ref: '#/components/schemas/BenefitLetter' '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. The link does not exist. content: application/json: schema: $ref: '#/components/schemas/Error404' components: schemas: BenefitLetter: description: >- A benefit letter of a link. `document_type` says which letter it is and which shape its `fields` take on retrieve. type: object properties: id: description: Benefit letter ID type: string readOnly: true example: 24d7e80942ce4ad58a93f70ce4115f5c document_type: description: >- Benefit letter type. It decides the shape of `fields` on retrieve. `VA_BENEFIT_LETTER` is the VA Benefit Verification letter, whose fields are described by `VaBenefitLetterFields`. `SSA_BENEFIT_LETTER` is reserved for the Social Security benefit letter; none are returned yet, and its `fields` will be documented when they are. type: string enum: - VA_BENEFIT_LETTER - SSA_BENEFIT_LETTER readOnly: true example: VA_BENEFIT_LETTER file: description: Link to the file the letter was read from type: string format: uri nullable: true readOnly: true example: https://cdn.truv.com/paystub_sample.pdf md5sum: description: MD5 checksum of the file type: string nullable: true readOnly: true example: 24d7e80942ce4ad58a93f70ce4115f5c created_at: description: Time the letter was first read type: string format: date-time readOnly: true example: '2026-09-02T10:15:30.123456Z' updated_at: description: Time the values read from the letter last changed type: string format: date-time readOnly: true example: '2026-09-02T10:15:30.123456Z' 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 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.