---
title: "v2-downloadOrderDocuments - Download documents from an order"
method: GET
path: "/v2/orders/{order_id}/documents"
tags: ["Orders"]
---

# v2-downloadOrderDocuments - Download documents from an order

`GET /v2/orders/{order_id}/documents`

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

Use this API to download documents from an order.


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

<div class="recommended-call-frequency">Recommended usage: On each order where we want to retrieve its documents</div>
<div class="max-call-frequency">Maximum usage: On each order where we want to retrieve its documents</div>
</div>

## Path parameters

- `order_id` string, required

## Query parameters

- `types` string[]
- `document_ids` string[]

## Response `200`

The requested document(s).

Always returns a ZIP archive.

The ZIP archive contains all matching documents with their original filenames (sorted by most recent first). For example, if <code>0024_COMMERCIAL_ID-A</code> contains 3 documents the ZIP archive structure will be as follows:
<pre> <code>
  0024_COMMERCIAL_ID-A_documents_1679996082000.zip
  ├── return_label.pdf
  ├── customer_invoice.pdf
  └── customer_invoice(1).pdf
</code> </pre>
Note: In case of multiple documents with the same name, a suffix (e.g. (1), (2), etc.) is added to the filenames in the ZIP archive to ensure uniqueness.

## Other responses

- `400` — Invalid or unsupported document type filter.
- `404` — Documents could not be retrieved because the order does not exist, no documents were found on this order, or when using <code>document_ids</code> filter, none of the requested documents exist or belong to the order.

---

[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)