---
title: "Retrieve upload record"
method: GET
path: "/v1/documents/uploads/{id}"
tags: ["Documents"]
---

# Retrieve upload record

`GET /v1/documents/uploads/{id}`

Retrieve a shipping document upload record.

## Path parameters

- `id` string, required

## Response `200`

- DocumentUploadRecord
  - `id` string — A unique identifier
  - `carrier_name` string, nullable — The shipment carrier
  - `carrier_id` string, nullable — The shipment carrier configured identifier
  - `documents` DocumentDetails[] — the carrier shipping document ids
    - `doc_id` string — The uploaded document id.
    - `file_name` string — The uploaded document file name.
  - `meta` object, nullable — provider specific metadata
  - `reference` string, nullable — Shipping document file reference
  - `messages` Message[] — The list of note or warning messages
    - `message` string — The error or warning message
    - `code` string — The message code
    - `details` object — any additional details
    - `carrier_name` string — The targeted carrier
    - `carrier_id` string — The targeted carrier name (unique identifier)

## Other responses

- `404`
- `500`

---

[API](https://skmtc.dev/karrio/apis/karrio-api.md) · [All operations](https://skmtc.dev/karrio/apis/karrio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/karrio/karrio-api/revisions/76ab3b7c3a61/schema)