---
title: "Upload a document"
method: POST
path: "/v1/numbers/papers"
tags: ["My numbers"]
---

# Upload a document

`POST /v1/numbers/papers`

Uploads a verification document for one or more phone numbers.
Uploaded files must meet the following requirements:
- Allowed formats: PNG, JPG, JPEG, TIFF, BMP, or PDF
- Maximum file size: 10 MB
- Files can't be password protected
- PDF files must not contain digital signatures

## Response `200`

Returns the uploaded documents and their review status.

- NumberDocument[]
  - `id` integer, required — Unique identifier of the uploaded document
  - `allow_replace` boolean, required — Indicates whether the document can be replaced. Only documents with `rejected` status can be replaced.
  - `did_number` string, required — The phone number the document was uploaded for
  - `doc_content_type` string, required — The uploaded content type identified by the platform
  - `doc_file_name` string, required — The uploaded document name
  - `doc_type_id` 1 | 2 | 3, required — Specifies the type of document required to activate the phone number. Possible values are: `1` - Proof of identity, `2` - Proof of address, `3` - Proof of business registration.
  - `status` string, required — Status of the uploaded document. Can be either `approved`, `pending`, or `rejected`
  - `url` string, required — A link to the uploaded document

## Other responses

- `400` — Request failed. Missing or invalid parameter <param_name>
- `403` — Request failed. The feature is disabled for your account.

---

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