---
title: "v2-uploadOrderDocument - Upload a document for an order"
method: POST
path: "/v2/orders/{order_id}/documents"
tags: ["Orders"]
---

# v2-uploadOrderDocument - Upload a document for an order

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

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

Use this API to upload a document for an order or its related entities (e.g. returns).

Supported document types are :
  - <code>RETURN_LABEL</code>
  - <code>CUSTOMER_INVOICE</code>


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

<div class="recommended-call-frequency">Recommended usage: On each document upload</div>
<div class="max-call-frequency">Maximum usage: On each document upload</div>
</div>

## Path parameters

- `order_id` string, required

## Response `202`

Accepted. The document upload request will be processed asynchronously.

- AsynchronousActionResponse
  - `action_id` string, required — The unique identifier for the asynchronous action. It should be used with the [v2-getActionStatus API](#operation/v2-getActionStatus) to retrieve current action status and potential errors.
  - `tracking_id` string — **Deprecated:** This field was previously used to obtain the action ID. It has been replaced by `action_id` and contains the same value. It is retained for backward compatibility.

## Other responses

- `400` — The document has not been uploaded because of wrong or missing parameters, invalid/unsupported file type, or file size exceeds limit.
- `404` — The document has not been uploaded because the order or entity does not exist.

---

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