---
title: "List all upload records"
method: GET
path: "/v1/documents/uploads"
tags: ["Documents"]
---

# List all upload records

`GET /v1/documents/uploads`

Retrieve all shipping document upload records.

## Query parameters

- `created_after` string, date-time
- `created_before` string, date-time
- `shipment_id` string

## Response `200`

- DocumentUploadRecords
  - `count` integer, nullable
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` DocumentUploadRecord[], required
    - `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)