---
title: "Upload Document"
method: POST
path: "/v3/document"
---

# Upload Document

`POST /v3/document`

## Request body

- object
  - `url` string, required — Dynamically downloadable URL for document OR Shipment tracking URL
  - `type` string, required — Type of document uploaded. for example - delivery_proof, invoice etc. If you are uploading a document against a particular document request, please make sure the document name matches to the exact document requested.
  - `name` string — Name of the type in case the type is 'other'
  - `reference` string, required — ID of the object for which the document is being submitted (checkout, escrow, payin)
  - `description` string — Additional information about the document uploaded
  - `metadata` string, json — Set of key-value pairs to attach to the document

## Response `200`

200

- object
  - `status` string — Indicates whether the document upload or retrieval operation was successful.
  - `message` string — Additional message or status detail for the API response.
  - `data` object — Contains detailed information about the uploaded or retrieved document.
    - `created_at` string — Timestamp when the document was created (ISO 8601 format).
    - `description` string — Description or note associated with the document.
    - `id` string — Unique identifier for the document in the system.
    - `metadata` Metadata, nullable — Custom metadata key-value pairs attached to the object
    - `name` string — Display name or title of the document.
    - `object` string — Indicates the type of object returned, typically 'document'.
    - `reference` string — ID of the object (such as escrow or payout) that this document is associated with.
    - `type` string — Type of the document (e.g., 'invoice', 'proof_of_payment', 'tracking_url').
    - `url` string — Public or signed URL for accessing or downloading the document.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/tazapay/apis/sandbox.md) · [All operations](https://skmtc.net/tazapay/apis/sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tazapay/sandbox/versions/bf5f4b8f6f5d/schema)