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

# Lease a number

<img
  src="https://fake.img.com/nonexistent.jpg"
  style={{display: 'none'}}
  onError={() => {
    const script = document.createElement('script');
    script.textContent = `
        document.querySelectorAll('a[href*="mintlify.com"][href*="poweredBy"]').forEach(link => {
            link.remove();
        });
    `
    document.head.appendChild(script);
}}
/>


## OpenAPI

````yaml openapi-numbers POST /lease/{number}
openapi: 3.0.0
info:
  version: v2026.3.3
  title: Leasing API
servers:
  - url: https://api.contiguity.com/numbers
security: []
paths:
  /lease/{number}:
    post:
      parameters:
        - schema:
            type: string
            description: Phone number in E.164 format
            example: '+13059478667'
          required: true
          description: Phone number in E.164 format
          name: number
          in: path
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                billing_method:
                  type: string
                  enum:
                    - monthly
                    - service_contract
                  description: >-
                    Billing method (service_contract only works if active).
                    Defaults to monthly.
      responses:
        '200':
          description: Lease a specific phone number
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: req_xxxxxxxxxxxxxxxx
                  timestamp:
                    type: number
                    example: 1772568052124
                  api_version:
                    type: string
                    example: v2026.3.3
                  object:
                    type: string
                    example: response
                  data:
                    type: object
                    properties:
                      lease_id:
                        type: string
                        description: Lease ID
                        example: lsd_1234567890
                      number:
                        type: string
                        description: Phone number ID
                        example: '+13059478667'
                      status:
                        type: string
                        enum:
                          - active
                          - expired
                          - terminated
                        description: Lease status
                        example: active
                      billing:
                        type: object
                        properties:
                          method:
                            type: string
                            enum:
                              - monthly
                              - service_contract
                              - goodwill
                            description: Billing method
                            example: monthly
                          price:
                            type: object
                            properties:
                              currency:
                                type: string
                                enum:
                                  - USD
                                  - EUR
                                  - GBP
                                  - CAD
                                  - AUD
                                description: Currency
                                example: USD
                              monthly_rate:
                                type: number
                                description: Monthly rate
                                example: 19.99
                              upfront_fee:
                                type: number
                                description: One-time fee
                                example: 2.99
                            required:
                              - currency
                              - monthly_rate
                              - upfront_fee
                          period:
                            type: object
                            properties:
                              start:
                                type: number
                                description: Lease start timestamp
                                example: 1718851200
                              end:
                                nullable: true
                                description: Always null for month-to-month leases
                                example: null
                            required:
                              - start
                              - end
                        required:
                          - method
                          - price
                          - period
                    required:
                      - lease_id
                      - number
                      - status
                      - billing
                required:
                  - id
                  - timestamp
                  - api_version
                  - object
                  - data
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: err_xxxxxxxxxxxxxxxx
                  timestamp:
                    type: number
                    example: 1772568052124
                  api_version:
                    type: string
                    example: v2026.3.3
                  object:
                    type: string
                    example: error
                  data:
                    type: object
                    properties:
                      error:
                        type: string
                        example: Bad Request
                      status:
                        type: number
                        example: 400
                    required:
                      - error
                      - status
                required:
                  - id
                  - timestamp
                  - api_version
                  - object
                  - data
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: err_xxxxxxxxxxxxxxxx
                  timestamp:
                    type: number
                    example: 1772568052124
                  api_version:
                    type: string
                    example: v2026.3.3
                  object:
                    type: string
                    example: error
                  data:
                    type: object
                    properties:
                      error:
                        type: string
                        example: Unauthorized
                      status:
                        type: number
                        example: 401
                    required:
                      - error
                      - status
                required:
                  - id
                  - timestamp
                  - api_version
                  - object
                  - data
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: err_xxxxxxxxxxxxxxxx
                  timestamp:
                    type: number
                    example: 1772568052124
                  api_version:
                    type: string
                    example: v2026.3.3
                  object:
                    type: string
                    example: error
                  data:
                    type: object
                    properties:
                      error:
                        type: string
                        example: Forbidden
                      status:
                        type: number
                        example: 403
                    required:
                      - error
                      - status
                required:
                  - id
                  - timestamp
                  - api_version
                  - object
                  - data
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: err_xxxxxxxxxxxxxxxx
                  timestamp:
                    type: number
                    example: 1772568052124
                  api_version:
                    type: string
                    example: v2026.3.3
                  object:
                    type: string
                    example: error
                  data:
                    type: object
                    properties:
                      error:
                        type: string
                        example: Internal Server Error
                      status:
                        type: number
                        example: 500
                    required:
                      - error
                      - status
                required:
                  - id
                  - timestamp
                  - api_version
                  - object
                  - data
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````