---
title: "Upload a Cross-border Supporting Document"
method: POST
path: "/api/b2b/cross-border/requests/documents"
tags: ["Cross-border Requests"]
---

# Upload a Cross-border Supporting Document

`POST /api/b2b/cross-border/requests/documents`

## Request

- Base URL: `https://api-v2.honeycoin.app`
- URL: `https://api-v2.honeycoin.app/api/b2b/cross-border/requests/documents`
- Auth: API key in header `Authorization`

Multipart upload in documents_required or documents_rejected. Uploading the same type replaces the document used for that type; a different type adds another document. Uploading does not submit documents for review.

## Request body `multipart/form-data`

- object
  - `crossBorderRequestId` string, required
  - `type` 'proforma_invoice' | 'contract', required
  - `file` string, binary, required: One nonempty file, at most 10 MiB. PDF, JPEG, PNG, GIF, WebP, HEIC or HEIF.

## Response `200`

Successful response.

- object
  - `success` true, required
  - `data` object, required
    - `id` string, required

## Other responses

- `400`: Invalid input.
- `403`: Resource belongs to another account.
- `404`: Resource not found.
- `409`: Duplicate or incompatible state.
- `422`: Missing documents or invalid lifecycle state.

## Changes

- **2026-11-03** `fcb58b0ef441`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/changes/api/b2b/cross-border/requests/documents/post.md)

---

[API](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official.md) - [All operations](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/llms.txt) - [OpenAPI document](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/revisions/fcb58b0ef441?raw)