> ## Documentation Index > Fetch the complete documentation index at: https://docs.wavix.com/llms.txt > Use this file to discover all available pages before exploring further. # Upload a document > 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 ## OpenAPI ````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml post /v1/numbers/papers openapi: 3.1.0 info: title: Wavix APIs description: >- Wavix provides robust APIs that let you integrate voice and text messaging features directly into your app. Send text, place calls, and access detailed reports programmatically. termsOfService: https://wavix.com/terms-and-conditions license: name: MIT identifier: MIT contact: name: Wavix url: https://wavix.com email: support@wavix.com version: '1.0' servers: - url: https://api.wavix.com description: https://api.wavix.com variables: {} security: - bearerAuth: [] tags: - name: SIP trunks description: SIP trunks - name: Buy description: Numbers - name: Cart description: Numbers - name: My numbers description: Numbers - name: Billing description: Billing, transactions, and invoices - name: Profile description: Account profile and customer information - name: CDRs description: Call detail records and call history - name: Speech Analytics description: Call transcription and speech analytics - name: SMS and MMS description: Messaging - name: Number Validator description: Phone number validation - name: Link shortener description: Short link and click metrics - name: 2FA description: Two-factor authentication - name: 10DLC description: 10DLC Campaigns and Brands - name: API Keys description: API key management - name: Call webhooks description: Webhook configuration for call events - name: Call control description: Programmable Voice - name: Call streaming description: Real-time call audio streaming over WebSocket - name: Call recording description: Call recording - name: Sub-accounts description: Sub-account management - name: Voice campaigns description: Outbound voice campaigns - name: Wavix Embeddable description: WebRTC embeddable widget paths: /v1/numbers/papers: post: tags: - My numbers summary: Upload a document description: |- 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 operationId: my_numbers_papers_upload parameters: [] requestBody: content: multipart/form-data: encoding: {} schema: required: - did_ids - doc_attachment - doc_id type: object additionalProperties: false properties: did_ids: type: string description: >- Comma-separated record IDs of the phone numbers the document applies to. example: '2321' doc_attachment: type: string description: >- Document file to upload. Allowed formats are PNG, JPG, JPEG, TIFF, BMP, and PDF. Maximum size is 10 MB. format: binary doc_id: $ref: '#/components/schemas/DocumentTypeID' required: false responses: '200': description: Returns the uploaded documents and their review status. content: application/json: schema: type: array items: $ref: '#/components/schemas/NumberDocument' examples: default: value: - id: 101 allow_replace: false did_number: '+14062355770' doc_content_type: image/png doc_file_name: user-id-card.png doc_type_id: 1 status: pending url: https://api.wavix.com/v1/numbers/1001/papers/101 - id: 102 allow_replace: true did_number: '+14062355771' doc_content_type: application/pdf doc_file_name: driver-license.pdf doc_type_id: 2 status: approved url: https://api.wavix.com/v1/numbers/1002/papers/102 '400': $ref: '#/components/responses/BadRequestErrorResponse' '403': $ref: '#/components/responses/ForbiddenErrorResponse' deprecated: false security: - bearerAuth: - numbers:write components: schemas: DocumentTypeID: title: DocumentTypeID enum: - 1 - 2 - 3 type: integer description: >- 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. NumberDocument: title: NumberDocument required: - id - allow_replace - did_number - doc_content_type - doc_file_name - doc_type_id - status - url type: object additionalProperties: false properties: id: type: integer description: Unique identifier of the uploaded document format: int32 example: 1 allow_replace: type: boolean description: >- Indicates whether the document can be replaced. Only documents with `rejected` status can be replaced. example: false did_number: type: string description: The phone number the document was uploaded for example: '12565378257' doc_content_type: type: string description: The uploaded content type identified by the platform example: image/png doc_file_name: type: string description: The uploaded document name example: Copy of ID.png doc_type_id: $ref: '#/components/schemas/DocumentTypeID' status: type: string description: >- Status of the uploaded document. Can be either `approved`, `pending`, or `rejected` url: type: string description: A link to the uploaded document example: https://api.wavix.com/v1/numbers/24882/papers/1" description: A document uploaded for a phone number example: id: 423 allow_replace: false did_number: '12565378257' doc_content_type: image/png doc_file_name: Copy of ID.png doc_type_id: 1 status: approved url: https://api.wavix.com/v1/numbers/24882/papers/1 ValidationErrorResponse: title: ValidationErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: >- Human-readable description naming the missing or invalid request parameter. example: Missing or invalid parameter ForbiddenErrorResponse: title: ForbiddenErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: Human-readable description of why access is forbidden. example: The service is not provisioned for your account. responses: BadRequestErrorResponse: description: Request failed. Missing or invalid parameter headers: {} content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' ForbiddenErrorResponse: description: Request failed. The feature is disabled for your account. headers: {} content: application/json: schema: $ref: '#/components/schemas/ForbiddenErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer description: > Wavix API key. Pass as `Authorization: Bearer `. Keys support per-resource scopes (none / read / write). See [Restricted keys and scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes). ````