---
title: "Upload Document"
method: POST
path: "/entity/{entityId}/document"
tags: ["entity > document"]
---

# Upload Document

`POST /entity/{entityId}/document`

## Request

- Base URL: `https://api.mercoa.com`
- URL: `https://api.mercoa.com/entity/{entityId}/document`
- Auth: HTTP bearer

Upload documents associated with this entity

## Path parameters

- `entityId` string, required

## Request body

- object
  - `document` string, required: Base64 encoded image or PDF of document. PNG, JPG, WEBP, and PDF are supported. 10MB max.
  - `type` 'INVOICE' | 'PAYMENT_CONFIRMATION' | 'TEN_NINETY_NINE' | 'W9' | 'CHECK' | 'BANK_STATEMENT' | 'CONTRACT' | 'OTHER', required

## Response `200`

Successful response

## Other responses

- `400`: Error response with status 400
- `401`: Error response with status 401
- `403`: Error response with status 403
- `404`: Error response with status 404
- `409`: Error response with status 409
- `500`: Error response with status 500
- `501`: Error response with status 501

---

[API](https://skmtc.dev/mercoa/apis/mercoa-2.md) - [All operations](https://skmtc.dev/mercoa/apis/mercoa-2/llms.txt) - [OpenAPI document](https://skmtc.dev/mercoa/apis/mercoa-2/revisions/00a8e403ae18?raw)