> ## Documentation Index
> Fetch the complete documentation index at: https://developer.amplify.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Purchase a number with requirements

> Purchase a phone number and submit its regulatory requirements.

Purchases the specified number while submitting the textual, document, and address evidence required for regulatory approval.

The optional top-level `type` field accepts `fax` or `voice`. Within each item in `requirements`, the observed `type` values are:

* `textual` for text-based evidence
* `document` for an uploaded verification document
* `address` for a verification address


## OpenAPI

````yaml POST /v1/numbers/purchase_with_requirements
openapi: 3.1.0
info:
  title: Amplify Customer API
  version: 1.0.0
  description: |-
    Canonical contract for the Amplify customer-facing API. This YAML file is
    the source of truth for Postman and Mintlify. Operations marked with
    x-amplify-validation-status: pending were migrated from the legacy Postman
    collection and must be validated before their contract is considered final.
servers:
  - url: https://api.amplify.xyz
    description: Production
  - url: https://dev-api.amplify.xyz
    description: Development
security: []
tags:
  - name: Authentication
  - name: Fax
  - name: Send Faxes
  - name: Receive Faxes
  - name: Manage Faxes
  - name: Workspace
  - name: Numbers
  - name: Contacts
  - name: Documents
  - name: Templates
paths:
  /v1/numbers/purchase_with_requirements:
    post:
      tags:
        - Numbers
      summary: Purchase a number with requirements
      description: >-
        Purchases an available phone number while submitting the regulatory
        information required for its country and number tier.
      operationId: postv1NumbersPurchaseWithRequirements
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                number:
                  type: string
                type:
                  type: string
                  enum:
                    - fax
                    - voice
                  description: Optional service type for the purchased number.
                country_code:
                  type: string
                tier:
                  type: integer
                requirements:
                  type: array
                  items:
                    type: object
                    properties:
                      requirement_id:
                        type: string
                      type:
                        type: string
                        enum:
                          - textual
                          - document
                          - address
                        description: >-
                          Kind of regulatory evidence supplied by this
                          requirement.
                      data:
                        type: string
                      other_data:
                        type: string
            example:
              number: '+41912470050'
              type: fax
              country_code: CH
              tier: 1
              requirements:
                - requirement_id: 0b42b42a-d827-4b53-a2bb-8eeef919f798
                  type: textual
                  data: '478458786548'
                  other_data: ''
                - requirement_id: 2708e569-696a-4fc7-9305-5fdb3eb9c7dd
                  type: textual
                  data: John doe
                  other_data: ''
                - requirement_id: 9ef887b6-7a28-47c3-964e-380680776561
                  type: document
                  data: 98853a6a-a3e2-4b59-b676-6bb081faf5e3.pdf
                  other_data: ''
                - requirement_id: a7d9a3a3-70ed-4cb4-821b-b94e8ea6dc9b
                  type: address
                  data: '3034108885616035274'
                  other_data: Wilerstrasse 3918, Amlikon-Bissegg, Switzerland
                - requirement_id: b0197fa1-c2fd-4500-9875-2c658b2396eb
                  type: document
                  data: 811a8f00-41c3-4e2d-8050-58c4c57b2663.pdf
                  other_data: ''
                - requirement_id: bf1cb27c-3693-41af-bbf6-ff4de8d41006
                  type: textual
                  data: john@doe.com
                  other_data: ''
                - requirement_id: d3641c72-734e-4421-8bca-510b4137c0c5
                  type: textual
                  data: John fintech
                  other_data: ''
                - requirement_id: ec029bc6-357f-404d-bdfd-f61d4e578896
                  type: document
                  data: 094ab602-4ea3-4497-836c-809a5d2ded86.pdf
                  other_data: ''
                - requirement_id: 80b88912-a16a-401d-afe4-28a47d31bf89
                  type: textual
                  data: '6985478521'
                  other_data: ''
                - requirement_id: d28957ae-1170-4b17-919f-e78b5b6dcdba
                  type: document
                  data: 67eb742d-e7ea-4e51-a144-f455037f2e92.pdf
                  other_data: ''
      responses:
        '200':
          description: >-
            The number was purchased and provisioned to the authenticated
            account.
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                  - data
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  data:
                    type: object
                    required:
                      - number_id
                      - order_id
                    properties:
                      number_id:
                        type: integer
                      order_id:
                        type: string
              example:
                status: 1
                message: Number purchased successfully
                data:
                  number_id: 2650
                  order_id: '3042009471086757685'
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````