---
title: "Retrieve parsed document"
method: GET
path: "/v1/links/{link_id}/parsed-documents/{doc_id}/"
tags: ["Parsed Documents"]
---

# Retrieve parsed document

`GET /v1/links/{link_id}/parsed-documents/{doc_id}/`

## Request

- Base URL: `https://prod.truv.com`
- URL: `https://prod.truv.com/v1/links/{link_id}/parsed-documents/{doc_id}/`
- Auth: API key in header `X-Access-Client-Id` and API key in header `X-Access-Secret`

The endpoint returns a parsed document with its extracted data. The `parsed_data` field contains structured information extracted from the document.
**Note:** Volunteer letters and military PCS orders 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.
For PCS orders, the `parsed_data` includes the service branch, pay grade, current and future duty stations, the report no later than (RNLT) date, tour length, dependent information, and the active duty service commitment.

## Response `200`

- ParsedDocumentRetrieve
  - `id` string: Parsed document ID
  - `document_type` 'VOLUNTEER_LETTER' | 'PCS_ORDERS', required: Document type.
  - `document_subtype` 'VOL_TRANSCRIPT' | 'VOL_HOURS_LOG' | 'null', nullable: Document subtype. Set for volunteer letters only; null for PCS orders.
  - `file` string, uri, nullable: Parsed document file link
  - `md5sum` string: Parsed document md5sum
  - `parsed_data` object, nullable: Parsed document data. The set of fields depends on the document type. 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 For PCS orders, this includes: - `branch`: Issuing service branch — Army, Navy, USMC, Air Force, Coast Guard or Space Force (string) - `rank`: Service member's rank normalized to a pay grade, e.g. `E-5` or `O-3` (string) - `current_duty_station`: Location the member is departing from (string) - `future_duty_station`: Location the member is reporting to (string) - `report_no_later_than_date`: Report no later than (RNLT) date, `YYYY-MM-DD` (string) - `tour_length`: Tour length when the order states one, e.g. `36 months` (string) - `dependents`: Dependent information when the order states any. Object containing: - `count`: Number of dependents (number) - `names`: Dependent names when the order lists them (array of strings) - `accompanied`: Whether dependent travel is authorized (boolean) - `active_duty_service_commitment`: Service commitment tied to the move, a duration or a date (string) Every PCS orders field is null when the order does not state it. Nothing is inferred.

## Other responses

- `401`: HTTP 401 Unauthorized
- `403`: HTTP 403 Forbidden
- `404`: HTTP 404 Not Found

## Changes

- **2026-09-12** `a14fbb94e588`: 1 warning
  - added the new `PCS_ORDERS` enum value to the `document_type` response property for the response status `200`

[Operation history](https://skmtc.dev/truv/apis/truv-api/changes/v1/links/:link_id/parsed-documents/:doc_id/get.md)

---

[API](https://skmtc.dev/truv/apis/truv-api.md) - [All operations](https://skmtc.dev/truv/apis/truv-api/llms.txt) - [OpenAPI document](https://skmtc.dev/truv/apis/truv-api/revisions/e20fd88e9371?raw)