---
title: "v2-listOrderDocuments - List documents"
method: GET
path: "/v2/orders/documents"
tags: ["Orders"]
---

# v2-listOrderDocuments - List documents

`GET /v2/orders/documents`

<div class="extension-title">Description</div>

Use this API to retrieve documents across orders with pagination support.

Each document in the response includes its associated order_id along with metadata such as name, type, size, and last update date.

Documents are returned as a flat list sorted by updated_at in descending order (most recent first).


<div class="api-description-extension">
<div class="extension-title">Call Frequency</div>

<div class="recommended-call-frequency">Recommended usage: When you need to retrieve documents for orders</div>
<div class="max-call-frequency">Maximum usage: When you need to retrieve documents for orders</div>
<div class="extension-title">Pagination</div>

<p>This resource supports seek pagination (<a href="#section/Seek-pagination-and-sort">see documentation</a>)</p>

<div class="extension-title">Sort fields</div>

<code>sort</code> field can have the following values:<ul><li><b>updated_at</b> (Default) - Sort by document last update time (desc by default)</li></ul>

</div>

## Query parameters

- `order_ids` string[]
- `types` string[]
- `channel_types` string[]
- `updated_from` string, date-time
- `page_token` string
- `limit` integer

## Response `200`

List of documents sorted by updated_at in descending order

- OrderDocumentsPageResponse
  - `next_page_token` string — Token to access the next page. Absent if the current page is the last one.
  - `previous_page_token` string — Token to access the previous page. Absent if the current page is the first one.
  - `documents` OrderDocumentResponse[], required — List of documents sorted by updated_at DESC
    - `channel_type` string — Channel-specific document type. This field contains the type identifier from the channel/marketplace side. This field is omitted if the document was created without a channel-specific type.
    - `file_format` string, required — Media type (MIME type) representing the file format of the document. This is a standardized identifier that indicates the nature and format of the document content. Common values include: - `application/pdf` for PDF documents - `image/jpeg` or `image/png` for images - `text/csv` for CSV files
    - `id` string, required — Document identifier in Mirakl Connect
    - `name` string, required — Name of the document file
    - `size_in_bytes` integer, required — Size of the document file in bytes
    - `type` string, required — Document type Enum: `"RETURN_LABEL"`, `"CUSTOMER_INVOICE"`, `"DELIVERY_SLIP"`, `"SHIPMENT_DELIVERY_SLIP"`, `"CHANNEL_SPECIFIC"`
    - `updated_at` string, date-time, required — Date and time when the document was last updated
    - `order_id` string, required — Order identifier in Mirakl Connect

## Other responses

- `400` — Invalid parameters.

---

[API](https://skmtc.net/mirakl/apis/mirakl-connect-apis.md) · [All operations](https://skmtc.net/mirakl/apis/mirakl-connect-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mirakl/mirakl-connect-apis/revisions/cc009fec5cdd/schema)