---
title: "S32 - Upload business documents to associate with a shop"
method: POST
path: "/api/shops/documents"
tags: ["Stores"]
---

# S32 - Upload business documents to associate with a shop

`POST /api/shops/documents`

## Request

- Base URL: `https://your-instance.mirakl.net`
- URL: `https://your-instance.mirakl.net/api/shops/documents`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://auth.mirakl.net/authorize`
    - Token URL: `https://auth.mirakl.net/oauth/token`
- TypeScript: <https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis/docs/api/shops/documents/post.ts> (a function with typed inputs; its response is checked against the schema)

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

Document filenames must be distinct and there can be only one file per document type.<br/>Only documents of the following types are supported: csv, doc, docx, gif, html, jpeg, latex, mp4, odp, odc, odg, ods, odt, pdf, png, pps, ppsx, ppt, pptx, quicktime, rtf, text, tiff, xls, xlsx, xml, zip<br/><span class='red'>You can upload a maximum of 50 business documents for each shop. These documents are not order related documents.</span>

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

<div class="recommended-call-frequency">Recommended usage: At each business document upload to a shop</div>
<div class="max-call-frequency">Maximum usage: 50 business documents per call</div>
<div class="extension-title">Read More</div>

<ul><li><a href="https://help.mirakl.com/bundle/customers/page/topics/Mirakl/mmp/Operator/manage_docs/manage_order_and_seller_docs/manage_order_and_seller_documents.html">More context</a></li></ul></div>

## Request body `multipart/form-data`

- object
  - `files` string[], required: Files to upload
  - `shop_documents` S32RequestMultipartFormDataShopDocuments, required
    - `shop_documents` S32RequestMultipartFormDataShopDocumentsShopDocuments[], required: Shop documents
      - `file_name` string, required: File name
      - `type_code` string, required: Document type code
  - `shop_id` integer, required: the shop identifier to add the documents to

## Response `200`

OK

- S32Response200
  - `documents` S32Response200Documents[], required: List of error reports associated to each document in an error state
    - `errors` S32Response200DocumentsErrors[], required: Errors about the input object
      - `code` string, required: Error code
      - `field` string, required: Name of the field on the input object. Can be composed, e.g.: address.zip_code
      - `message` string, required: Error message
  - `errors_count` integer: The number of documents in an error state

---

[API](https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis.md) - [All operations](https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis/revisions/dd54ccb6550e?raw)