> ## Documentation Index > Fetch the complete documentation index at: https://terminal49.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get a document > Retrieve a single document record from the Terminal49 API, including classification, extraction status, and links to the file blob and last representation. **Beta Feature** - This endpoint is currently in beta. The API is stable, but the schema and behavior may evolve based on feedback. ## OpenAPI ````yaml get /documents/{id} openapi: 3.0.0 info: title: Terminal49 API Reference version: 0.2.0 contact: name: Terminal49 API support url: https://www.terminal49.com email: support@terminal49.com description: >- The Terminal 49 API offers a convenient way to programmatically track your shipments from origin to destination. Please enter your API key into the "Variables" tab before using these endpoints within Postman. x-label: Beta termsOfService: https://www.terminal49.com/terms servers: - url: https://api.terminal49.com/v2 description: Production security: - authorization: [] tags: - name: Containers - name: Custom Field Definitions - name: Custom Field Options - name: Custom Fields - name: Shipments - name: Locations - name: Events - name: Tracking Requests - name: Webhooks - name: Webhook Notifications - name: Ports - name: Metro Areas - name: Terminals - name: Routing (Paid) - name: Documents - name: Email Submissions - name: Document Schemas - name: Search paths: /documents/{id}: get: tags: - Documents summary: Get a document operationId: get-documents-id parameters: - in: path name: id required: true schema: type: string format: uuid - in: query name: include schema: type: string description: >- Comma-separated includes. Allowed: shipments, cargos, account, user, last_document_representation, email_submission, current_extraction (alias for last_document_representation). responses: '200': description: OK content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/document' included: type: array items: anyOf: - $ref: '#/components/schemas/account' - cff5e9a0-1c4a-4253-a0cf-d58b81074cc5 - $ref: '#/components/schemas/shipment' - $ref: '#/components/schemas/container' - $ref: '#/components/schemas/document' - $ref: '#/components/schemas/document_email_submission' - $ref: '#/components/schemas/document_representation' links: $ref: '#/components/schemas/link-self' '400': description: Bad Request content: application/json: schema: type: object properties: errors: type: array items: $ref: '#/components/schemas/error' '404': description: Not Found content: application/json: schema: type: object properties: errors: type: array items: $ref: '#/components/schemas/error' examples: document_not_found: summary: Document not found value: errors: - status: '404' title: Not Found detail: Couldn't find Document components: schemas: document: title: Document type: object properties: id: type: string format: uuid type: type: string enum: - document attributes: type: object properties: id: description: Unique identifier for the document. type: string format: uuid name: description: Display name of the document. type: string document_type: description: System-classified document type. type: string document_type_manual: description: Document type set manually by a user, when available. type: string nullable: true classification_notes: description: Additional notes captured during document classification. type: string nullable: true source: description: How the document was created in Terminal49. type: string enum: - upload - api - email - split_document file_name: description: Original file name of the uploaded or generated document. type: string file_content_type: description: MIME type of the document file. type: string nullable: true file_size_bytes: description: File size in bytes. type: integer nullable: true created_at: description: Timestamp when the document was created. type: string format: date-time updated_at: description: Timestamp when the document was last updated. type: string format: date-time relationships: type: object properties: account: type: object properties: data: type: object properties: id: type: string format: uuid type: type: string enum: - account user: type: object properties: data: type: object nullable: true properties: id: type: string format: uuid type: type: string enum: - user email_submission: type: object properties: data: type: object nullable: true properties: id: type: string format: uuid type: type: string enum: - email_submission last_document_representation: type: object properties: data: type: object nullable: true properties: id: type: string format: uuid type: type: string enum: - document_representation shipments: type: object properties: data: type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - shipment cargos: type: object properties: data: type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - container links: type: object properties: self: type: string download: type: string required: - id - type account: title: Account model type: object properties: id: type: string format: uuid type: type: string enum: - account attributes: type: object required: - company_name properties: company_name: type: string required: - id - type - attributes x-examples: {} shipment: title: Shipment model type: object x-examples: {} description: '' properties: id: type: string format: uuid relationships: type: object properties: destination: type: object properties: data: type: object nullable: true properties: type: type: string enum: - port - metro_area id: type: string format: uuid required: - type - id port_of_lading: type: object properties: data: type: object nullable: true properties: type: type: string enum: - port id: type: string format: uuid required: - type - id containers: type: object properties: data: type: array items: type: object properties: type: type: string enum: - container id: type: string format: uuid required: - type - id port_of_discharge: type: object properties: data: type: object nullable: true properties: type: type: string enum: - port id: type: string format: uuid required: - type - id pod_terminal: type: object properties: data: type: object properties: type: type: string enum: - terminal id: type: string format: uuid required: - type - id destination_terminal: type: object properties: data: type: object properties: type: type: string enum: - terminal - rail_terminal id: type: string format: uuid required: - type - id line_tracking_stopped_by_user: type: object properties: data: type: object properties: type: type: string enum: - user id: type: string format: uuid required: - type - id attributes: type: object properties: bill_of_lading_number: type: string normalized_number: type: string description: >- The normalized version of the shipment number used for querying the carrier ref_numbers: type: array items: type: string nullable: true created_at: type: string format: date-time tags: type: array items: type: string port_of_lading_locode: type: string description: UN/LOCODE nullable: true port_of_lading_name: type: string nullable: true port_of_discharge_locode: type: string description: UN/LOCODE nullable: true port_of_discharge_name: type: string nullable: true destination_locode: type: string description: UN/LOCODE nullable: true destination_name: type: string nullable: true shipping_line_scac: type: string shipping_line_name: type: string shipping_line_short_name: type: string customer_name: type: string nullable: true pod_vessel_name: type: string nullable: true pod_vessel_imo: type: string nullable: true pod_voyage_number: type: string nullable: true pol_etd_at: type: string format: date-time description: >- Estimated Time of Departure from the Port of Lading, as reported by the shipping line. Carrier dependent; may be null. nullable: true pol_atd_at: type: string format: date-time description: >- Actual Time of Departure from the Port of Lading. Populated after the vessel has departed the origin port. nullable: true pod_eta_at: type: string format: date-time description: Estimated Time of Arrival at the Port of Discharge. nullable: true pod_original_eta_at: type: string format: date-time description: >- Initial Estimated Time of Arrival at the Port of Discharge, as first reported by the shipping line. nullable: true pod_ata_at: type: string format: date-time description: Actual Time of Arrival at the Port of Discharge. nullable: true destination_eta_at: type: string format: date-time description: >- Estimated Time of Arrival at the shipment's destination, as reported by the shipping line. For inland (rail) moves, see also the container-level `ind_eta_at`, which is reported by the rail carrier. Corresponding timezone is `destination_timezone`. nullable: true destination_ata_at: type: string format: date-time description: >- Actual Time of Arrival at the shipment's destination, as reported by the shipping line. For inland (rail) moves, see also the container-level `ind_ata_at`, which is reported by the rail carrier. Corresponding timezone is `destination_timezone`. nullable: true pol_timezone: type: string description: IANA tz nullable: true pod_timezone: type: string description: IANA tz nullable: true destination_timezone: type: string description: IANA tz nullable: true line_tracking_last_attempted_at: type: string format: date-time description: >- When Terminal49 last tried to update the shipment status from the shipping line nullable: true line_tracking_last_succeeded_at: type: string format: date-time description: >- When Terminal49 last successfully updated the shipment status from the shipping line nullable: true line_tracking_stopped_at: type: string format: date-time description: When Terminal49 stopped checking at the shipping line nullable: true line_tracking_stopped_reason: type: string enum: - all_containers_terminated - past_arrival_window - past_full_out_window - no_updates_at_line - cancelled_by_user - booking_cancelled - null description: The reason Terminal49 stopped checking nullable: true required: - bill_of_lading_number type: type: string enum: - shipment links: type: object properties: self: type: string format: uri required: - self required: - id - type - attributes - relationships - links container: title: Container model type: object x-examples: Example Container: id: ff77a822-23a7-4ccd-95ca-g534c071baaf3 type: container attributes: number: KOCU4959010 ref_numbers: - REF-1 - REF-2 seal_number: '210084213' created_at: '2021-10-18T09:52:33Z' equipment_type: dry equipment_length: 40 equipment_height: high_cube weight_in_lbs: 20210 fees_at_pod_terminal: [] holds_at_pod_terminal: [] pickup_lfd: '2022-01-21T08:00:00Z' pickup_appointment_at: null pod_full_out_chassis_number: APMZ418805 location_at_pod_terminal: Delivered 02/11/2022 14:18 availability_known: true available_for_pickup: false pod_arrived_at: '2022-01-03T10:30:00Z' pod_discharged_at: '2022-01-08T09:15:00Z' final_destination_full_out_at: null pod_full_out_at: '2022-02-11T22:18:00Z' empty_terminated_at: null terminal_checked_at: '2022-02-11T22:45:32Z' pod_rail_carrier_scac: UPRR ind_rail_carrier_scac: CSXT pod_timezone: America/Los_Angeles final_destination_timezone: null empty_terminated_timezone: null pod_last_tracking_request_at: '2022-02-11T22:40:00Z' shipment_last_tracking_request_at: '2022-02-11T22:40:00Z' pod_rail_loaded_at: '2022-02-11T22:18:00Z' pod_rail_departed_at: '2022-02-11T23:30:00Z' ind_eta_at: null ind_ata_at: '2022-02-15T01:12:00Z' ind_rail_unloaded_at: '2022-02-15T07:54:00Z' ind_facility_lfd_on: null import_deadlines: pickup_lfd_terminal: null pickup_lfd_rail: '2022-02-20T08:00:00Z' pickup_lfd_line: '2022-02-25T08:00:00Z' current_status: delivered relationships: shipment: data: id: x92acf88-c263-43ddf-b005-aca2a32d47f1 type: shipment pod_terminal: data: id: x551cac7-aff5-40a6-9c63-49facf19cc3df type: terminal pickup_facility: data: id: d7d8d314-b02b-4caa-b04f-d3d4726f4107 type: terminal transport_events: data: - id: xecfe2d1-c498-4022-a9f8-ec56722e1215 type: transport_event - id: 2900a9b8-d9e2-4696-abd86-4a767b885d23 type: transport_event - id: 5ad0dce1-x78e4-464d-af5f-a36190428a2c type: transport_event - id: 876575d5-5ede-40d6-a093-c3a4cfcxaa1c7 type: transport_event - id: dc2a9d8f-75e6-43xa5-a04e-58458495f08c type: transport_event - id: 50xd2ea1-01ac-473d-8a08-3b5d77d2b793 type: transport_event - id: 9d1f55xe3-6758-4be7-872a-30451ddd957e type: transport_event raw_events: data: - id: 38084a1d-a2eb-434e-81ac3-606c89a61c4b type: raw_event - id: 53680df3-93d5-4385-86c5-a33ee41b4c1f type: raw_event - id: 7d9cdf70-51e8-4b75-a8229-f5d691495ab6 type: raw_event - id: e62d41ac-8738-42e8-b582-35ef28ae88e2 type: raw_event - id: 1209172b-acd8-4ce0-8821-dbc4934208b3 type: raw_event - id: 4265ea5f-2b9a-436f-98fa-803d8ed49acb2 type: raw_event - id: c3cb2eb7-6c0a-4db8-8742-517b97b175d5 type: raw_event - id: b1959f36-a218-4b6e-863a9-2e0b4ad5159c type: raw_event description: Represents the equipment during a specific journey. properties: id: type: string format: uuid type: type: string enum: - account attributes: type: object properties: number: type: string ref_numbers: type: array items: type: string equipment_type: type: string enum: - dry - reefer - open top - flat rack - bulk - tank - null nullable: true equipment_length: type: integer enum: - null - 10 - 20 - 40 - 45 nullable: true equipment_height: type: string enum: - standard - high_cube - null nullable: true weight_in_lbs: type: number nullable: true created_at: type: string format: date-time seal_number: type: string nullable: true pickup_lfd: type: string format: date-time description: >- Coalesces `import_deadlines` values giving preference to `pickup_lfd_line` nullable: true pickup_appointment_at: type: string format: date-time description: >- When available the pickup appointment time at the terminal is returned. nullable: true availability_known: type: boolean description: >- Whether Terminal 49 is receiving availability status from the terminal. available_for_pickup: type: boolean description: >- If availability_known is true, then whether container is available to be picked up at terminal. nullable: true pod_arrived_at: type: string format: date-time description: Time the vessel arrived at the POD nullable: true pod_discharged_at: type: string format: date-time description: Discharge time at the port of discharge nullable: true pod_full_out_at: type: string format: date-time description: Full Out time at port of discharge. Null for inland moves. nullable: true terminal_checked_at: type: string format: date-time description: When the terminal was last checked. nullable: true pod_full_out_chassis_number: type: string description: >- The chassis number used when container was picked up at POD (if available) nullable: true location_at_pod_terminal: type: string description: Location at port of discharge terminal nullable: true final_destination_full_out_at: type: string format: date-time description: Pickup time at final destination for inland moves. nullable: true empty_terminated_at: type: string format: date-time description: Time empty container was returned. nullable: true holds_at_pod_terminal: type: array items: $ref: '#/components/schemas/terminal_hold' fees_at_pod_terminal: type: array items: $ref: '#/components/schemas/terminal_fee' pod_timezone: type: string description: >- IANA tz. Applies to attributes pod_arrived_at, pod_discharged_at, pickup_appointment_at, pod_full_out_at. nullable: true final_destination_timezone: type: string description: IANA tz. Applies to attribute final_destination_full_out_at. nullable: true empty_terminated_timezone: type: string description: IANA tz. Applies to attribute empty_terminated_at. nullable: true pod_rail_carrier_scac: type: string description: >- The SCAC of the rail carrier for the pickup leg of the container's journey.(BETA) nullable: true ind_rail_carrier_scac: type: string description: >- The SCAC of the rail carrier for the delivery leg of the container's journey.(BETA) nullable: true pod_last_tracking_request_at: type: string format: date-time nullable: true shipment_last_tracking_request_at: type: string format: date-time nullable: true pod_rail_loaded_at: type: string format: date-time nullable: true pod_rail_departed_at: type: string format: date-time nullable: true ind_eta_at: type: string format: date-time description: >- Estimated Time of Arrival at the inland destination, as reported by the rail carrier. For the shipping-line view at the shipment's destination, see `destination_eta_at` on the shipment. Corresponding timezone is `final_destination_timezone`. nullable: true ind_ata_at: type: string format: date-time description: >- Actual Time of Arrival at the inland destination, as reported by the rail carrier. For the shipping-line view at the shipment's destination, see `destination_ata_at` on the shipment. Corresponding timezone is `final_destination_timezone`. nullable: true ind_rail_unloaded_at: type: string format: date-time description: >- Time when the container is unloaded from rail at the inland destination. nullable: true ind_facility_lfd_on: type: string format: date-time description: Please use `import_deadlines.pickup_lfd_rail` nullable: true deprecated: true import_deadlines: type: object description: Import pickup deadlines for the container properties: pickup_lfd_terminal: type: string format: date-time description: >- The last free day for pickup before demmurage accrues. Corresponding timezone is pod_timezone. nullable: true pickup_lfd_rail: type: string format: date-time description: >- The last free day for pickup at the inland destination, as reported by the rail carrier. Corresponding timezone is final_destination_timezone. Subscribe to `container.pickup_lfd_rail.changed` to be notified of updates. nullable: true pickup_lfd_line: type: string format: date-time description: >- The last free day as reported by the shipping line (carrier dependent). Corresponding timezone is final_destination_timezone or pod_timezone. Preferred source for the coalesced top-level `pickup_lfd` field. nullable: true nullable: true current_status: type: string description: >- The current status of the container in its journey. [Read guide to learn more.](/api-docs/in-depth-guides/container-statuses) enum: - new - on_ship - available - not_available - grounded - on_rail - picked_up - off_dock - delivered - dropped - loaded - empty_returned - awaiting_inland_transfer relationships: type: object properties: shipment: type: object properties: data: type: object properties: id: type: string type: type: string enum: - shipment pickup_facility: type: object properties: data: type: object properties: id: type: string type: type: string enum: - terminal pod_terminal: type: object properties: data: type: object properties: id: type: string type: type: string enum: - terminal transport_events: type: object properties: data: type: array items: type: object properties: id: type: string type: type: string enum: - transport_event raw_events: type: object properties: data: type: array items: type: object properties: id: type: string type: type: string enum: - raw_event required: - id - type - attributes document_email_submission: title: Document Email Submission type: object properties: id: type: string format: uuid type: type: string enum: - email_submission attributes: type: object properties: subject: type: string nullable: true body_preview: type: string nullable: true from: type: array items: type: string to: type: array items: type: string cc: type: array items: type: string message_id: type: string nullable: true sent_at: type: string format: date-time nullable: true created_at: type: string format: date-time updated_at: type: string format: date-time required: - id - type document_representation: title: Document Representation type: object properties: id: type: string format: uuid type: type: string enum: - document_representation attributes: type: object properties: schema_version: type: string payload: type: object additionalProperties: true created_at: type: string format: date-time updated_at: type: string format: date-time required: - id - type link-self: title: link type: object properties: self: type: string format: uri error: title: Error model type: object properties: detail: type: string nullable: true title: type: string nullable: true source: type: object nullable: true properties: pointer: type: string nullable: true parameter: type: string nullable: true code: type: string nullable: true status: type: string nullable: true meta: type: object nullable: true additionalProperties: true required: - title terminal_hold: title: terminal_hold type: object properties: name: type: string status: type: string enum: - pending - hold description: type: string description: Text description from the terminal (if any) nullable: true required: - name - status terminal_fee: title: terminal_fee type: object properties: type: type: string enum: - demurrage - exam - extended_dwell_time - other - total amount: type: number description: The fee amount in local currency currency_code: type: string description: The ISO 4217 currency code of the fee is charged in. E.g. USD example: USD required: - type - amount securitySchemes: authorization: name: Authorization type: apiKey in: header description: >- Use a Terminal49 API key in the `Authorization` header with the `Token` prefix. `Authorization: Token YOUR_API_KEY` ````