---
title: "Document Upload"
method: PUT
path: "/identity/identities/{identity_id}/documents"
tags: ["Identity Documents"]
---

# Document Upload

`PUT /identity/identities/{identity_id}/documents`

This endpoint enables you to receive a URL to upload a document to Paxos for identity verification or enhanced due diligence purposes.
When uploading a document you must specify the document type. You will receive a
URL where you can upload the document using a POST request.

Requirements:
- Uploaded documents must be less than 100 MB in size
- Supported formats include PDF, JPG, and PNG

For more information on document requirements for enhanced due diligence, see [here](https://docs.paxos.com/identity/edd).

## Path parameters

- `identity_id` string, required

## Request body

- IdentityPublicDocumentUploadBody
  - `name` string, required — The file name.
  - `document_types` DocumentType[] — A list of document types contained within the uploaded file.

## Response `200`

A successful response.

- DocumentUploadResponse
  - `file_id` string — The id assigned to the file.
  - `name` string — The file name.
  - `upload_url` string — The URI where we expect the file to be uploaded into.

## Other responses

- `400` — Bad Request
- `403` — Permissions Denied
- `404` — Not Found
- `409` — Already Exists

---

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