RingCentral Phone Numbers API

openapi: 3.2.0
info:
  title: RingCentral Adaptive Cards Phone Numbers API
  description: RingCentral API specification
  version: 1.0.58-20240529-47eda8bd
  contact:
    name: RingCentral Developers Support
    url: https://developers.ringcentral.com/support
  termsOfService: https://www.ringcentral.com/legal/apilitos.html
  license:
    name: RingCentral API License Agreement
    url: https://www.ringcentral.com/legal/apilitos.html
servers:
- url: https://platform.ringcentral.com
  description: Production API entry point
- url: https://media.ringcentral.com
  description: Production Media entry point
- url: https://platform.devtest.ringcentral.com
  description: Developer sandbox API entry point
- url: https://platform.devtest.ringcentral.com
  description: Developer sandbox Media entry point
security:
- OAuth2: []
tags:
- name: Phone Numbers
paths:
  /restapi/v2/accounts/{accountId}/phone-numbers:
    get:
      tags:
      - Phone Numbers
      summary: List Account Phone Numbers
      description: 'Returns the list of phone numbers assigned to RingCentral customer

        account. Both company-level and extension-level numbers are returned.

        Conferencing numbers, hot desk and ELIN numbers are not returned.

        '
      operationId: listAccountPhoneNumbersV2
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/PerPage'
      - name: type
        in: query
        description: Types of phone numbers to be returned
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/PhoneNumberType'
      - name: usageType
        in: query
        description: Usage type(s) of phone numbers to be returned
        style: form
        explode: true
        schema:
          type: array
          items:
            $ref: '#/components/schemas/PhoneNumberUsageType'
      - name: status
        in: query
        required: false
        description: Status of the phone number(s) to be returned
        schema:
          $ref: '#/components/schemas/PhoneNumberStatus'
      - name: tollType
        in: query
        required: false
        description: Toll type of phone numbers to return
        schema:
          $ref: '#/components/schemas/PhoneNumberTollType'
      - name: extensionStatus
        in: query
        description: Statuses of extensions to return phone numbers for
        required: false
        schema:
          $ref: '#/components/schemas/ExtensionStatus'
      - name: byocNumber
        in: query
        description: The parameter reflects whether this number is BYOC or not
        required: false
        schema:
          type: boolean
      - name: phoneNumber
        in: query
        description: 'Phone number in e.164 format to be searched for.

          Parameter value can include wildcards (e.g. "+165012345**")

          or be an exact number "+16501234500" - single number is searched in that case.

          Make sure you escape the "+" in the URL as "%2B"

          '
        required: false
        schema:
          type: string
          maxLength: 18
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountPhoneNumberList'
              examples:
                ListAccountPhoneNumbersResponse:
                  $ref: '#/components/examples/ListAccountPhoneNumbersResponse'
        '400':
          $ref: '#/components/responses/InvalidRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceNotAvailable'
      x-availability: Limited
      x-throttling-group: Heavy
      x-app-permission: ReadAccounts
      x-user-permission: ReadCompanyPhoneNumbers
    delete:
      tags:
      - Phone Numbers
      summary: Delete Numbers from Inventory
      description: "This method can only delete numbers that meet one of the following requirements:\n  - numbers that have `\"usageType\": \"Inventory\"`\n  - `\"Forwarded\"` numbers\n  - `\"Forwarded Company\"` numbers\n\nIn other words, this method will not delete numbers which are in use on the account - extension direct numbers,\nmain number, etc. It is possible to indicate phone numbers to be deleted using their IDs or exact string values\nin e.164 format. However, the same lookup method (by ID or by value) must be used for all numbers within the same API call.\n"
      operationId: deleteNumbersFromInventoryV2
      parameters:
      - $ref: '#/components/parameters/AccountId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeletePhoneNumbersRequest'
            examples:
              DeletePhoneNumbersRequest:
                $ref: '#/components/examples/DeletePhoneNumbersRequest'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletePhoneNumbersResponse'
              examples:
                DeletePhoneNumbersResponse:
                  $ref: '#/components/examples/DeletePhoneNumbersResponse'
        '400':
          $ref: '#/components/responses/InvalidRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceNotAvailable'
      x-availability: Limited
      x-throttling-group: Medium
      x-app-permission: EditAccounts
      x-user-permission: EditCompanyPhoneNumbers
  /restapi/v2/accounts/{accountId}/phone-numbers/{phoneNumberId}:
    patch:
      tags:
      - Phone Numbers
      summary: Assign Phone Number
      description: 'Assigns or reassigns a phone number as a company or extension number.


        Assign scenarios supported:

        - from Inventory to a company number;

        - from Inventory to an extension number.


        Reassign scenarios supported:

        - from an extension to another extension;

        - from an extension to a company number;

        - from a company number to an extension.

        '
      operationId: assignPhoneNumberV2
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - $ref: '#/components/parameters/PhoneNumberId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AssignPhoneNumberRequest'
            examples:
              AssignPhoneNumberRequest:
                $ref: '#/components/examples/AssignPhoneNumberRequest'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountPhoneNumberInfo'
              examples:
                AssignPhoneNumberResponse:
                  $ref: '#/components/examples/AssignPhoneNumberResponse'
        '400':
          $ref: '#/components/responses/InvalidRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceNotAvailable'
      x-availability: Limited
      x-throttling-group: Medium
      x-app-permission: EditAccounts
      x-user-permission: EditCompanyPhoneNumbers
  /restapi/v2/accounts/{accountId}/phone-numbers/{phoneNumberId}/replace:
    post:
      tags:
      - Phone Numbers
      summary: Replace Phone Number
      description: 'Replaces (swaps) phone numbers from Inventory with the main, company, direct or company fax numbers.

        This method is used to replace temporary numbers when the porting process is complete.

        '
      operationId: replacePhoneNumberV2
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - $ref: '#/components/parameters/PhoneNumberId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReplacePhoneNumberRequest'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountPhoneNumberInfo'
        '400':
          $ref: '#/components/responses/InvalidRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceNotAvailable'
      x-availability: Limited
      x-throttling-group: Medium
      x-app-permission: EditAccounts
      x-user-permission: EditCompanyPhoneNumbers
  /restapi/v2/accounts/{accountId}/phone-numbers/bulk-add:
    post:
      tags:
      - Phone Numbers
      summary: Add Numbers to Inventory
      description: 'Adds phone numbers to the account Inventory as unassigned. Currently, we support the following values: `Inventory`,

        `InventoryPartnerBusinessMobileNumber` and `PartnerBusinessMobileNumber`. Later we may support some other values like `ForwardedNumber`, etc.

        '
      operationId: addNumbersToInventoryV2
      parameters:
      - $ref: '#/components/parameters/AccountId'
      requestBody:
        description: List of phone numbers
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddPhoneNumbersRequest'
            examples:
              AddPhoneNumbersRequest:
                $ref: '#/components/examples/AddPhoneNumbersRequest'
        required: true
      responses:
        '200':
          description: Successful response (synchronous operation)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddPhoneNumbersResponse'
              examples:
                AddPhoneNumbersResponse:
                  $ref: '#/components/examples/AddPhoneNumbersResponse'
        '202':
          description: Successful response (asynchronous operation)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddPhoneNumbersTask'
        '400':
          $ref: '#/components/responses/InvalidRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceNotAvailable'
      x-availability: Limited
      x-throttling-group: Heavy
      x-app-permission: EditAccounts
      x-user-permission: EditCompanyPhoneNumbers
  /restapi/v2/accounts/{accountId}/phone-numbers/bulk-add/{taskId}:
    get:
      tags:
      - Phone Numbers
      summary: Get Add Numbers Task Results
      description: 'Returns the result of asynchronous operation which adds phone numbers to the account Inventory.

        '
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - name: taskId
        in: path
        description: Identifier of a task returned by asynchronous bulk add operation
        required: true
        schema:
          type: string
      operationId: getBulkAddTaskResultsV2
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/AddPhoneNumbersResponse'
                - $ref: '#/components/schemas/AddPhoneNumbersTask'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceNotAvailable'
      x-availability: Limited
      x-throttling-group: Heavy
      x-app-permission: EditAccounts
      x-user-permission: EditCompanyPhoneNumbers
  /restapi/v1.0/account/{accountId}/extension/{extensionId}/phone-number:
    get:
      tags:
      - Phone Numbers
      summary: Get Extension Phone Number List
      description: 'Returns the list of phone numbers that are used by a particular extension,

        can be filtered by the phone number type. The returned list contains all

        numbers which are directly mapped to the given extension. Plus the features

        and company-level numbers that may be used when performing different operations

        on behalf of this extension.

        '
      operationId: listExtensionPhoneNumbers
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - $ref: '#/components/parameters/ExtensionId'
      - name: status
        in: query
        description: Status of a phone number
        schema:
          type: string
          enum:
          - Normal
          - Pending
          - PortedIn
          - Temporary
      - name: usageType
        in: query
        description: Usage type of phone number
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            enum:
            - MainCompanyNumber
            - AdditionalCompanyNumber
            - CompanyNumber
            - DirectNumber
            - CompanyFaxNumber
            - ForwardedNumber
            - ForwardedCompanyNumber
            - BusinessMobileNumber
            - PartnerBusinessMobileNumber
            - IntegrationNumber
      - name: page
        in: query
        description: 'Indicates a page number to retrieve. Only positive number values

          are allowed. Default value is ''1''

          '
        schema:
          type: integer
          format: int32
          default: 1
      - name: perPage
        in: query
        description: Indicates a page size (number of items). If not specified, the value is '100' by default
        schema:
          type: integer
          format: int32
          default: 100
      responses:
        '200':
          description: 'OK: User Phone Number List'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetExtensionPhoneNumbersResponse'
      x-feature: ReadExtensionPhoneNumbers
      x-availability: High
      x-throttling-group: Light
      x-app-permission: ReadAccounts
      x-user-permission: ReadUserPhoneNumbers
  /restapi/v1.0/account/{accountId}/phone-number:
    get:
      tags:
      - Phone Numbers
      summary: List Company Phone Numbers
      description: 'Returns the list of phone numbers assigned to RingCentral customer

        account. Both company-level and extension-level numbers are returned.

        '
      operationId: listAccountPhoneNumbers
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - name: page
        in: query
        description: 'Indicates a page number to retrieve. Only positive number values

          are accepted

          '
        schema:
          type: integer
          format: int32
          default: 1
      - name: perPage
        in: query
        description: Indicates a page size (number of items)
        schema:
          type: integer
          format: int32
          default: 100
      - name: usageType
        in: query
        description: Usage type of phone number
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            enum:
            - MainCompanyNumber
            - AdditionalCompanyNumber
            - CompanyNumber
            - DirectNumber
            - CompanyFaxNumber
            - ForwardedNumber
            - ForwardedCompanyNumber
            - ContactCenterNumber
            - ConferencingNumber
            - MeetingsNumber
            - BusinessMobileNumber
            - PartnerBusinessMobileNumber
            - IntegrationNumber
      - name: paymentType
        in: query
        description: Payment Type of the number
        schema:
          $ref: '#/components/schemas/PlatformPaymentType'
      - name: status
        in: query
        description: Status of a phone number
        schema:
          type: string
          enum:
          - Normal
          - Pending
          - PortedIn
          - Temporary
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountPhoneNumbers'
      x-feature: ReadAccountPhoneNumbers
      x-availability: High
      x-throttling-group: Heavy
      x-app-permission: ReadAccounts
      x-user-permission: ReadCompanyPhoneNumbers
  /restapi/v1.0/account/{accountId}/phone-number/{phoneNumberId}:
    get:
      tags:
      - Phone Numbers
      summary: Get Phone Number
      description: 'Returns phone number(s) belonging to a certain account or extension by phoneNumberId(s).

        [Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported.

        '
      operationId: readAccountPhoneNumber
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - name: phoneNumberId
        in: path
        description: Internal identifier of a phone number
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: Phone number information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyPhoneNumberInfo'
      x-feature: ReadAccountPhoneNumbers
      x-availability: High
      x-throttling-group: Light
      x-app-permission: ReadAccounts
      x-user-permission: ReadCompanyPhoneNumbers
  /restapi/v1.0/number-parser/parse:
    post:
      tags:
      - Phone Numbers
      summary: Parse Phone Number(s)
      description: Returns one or more parsed and/or formatted phone numbers that are passed as strings.
      operationId: parsePhoneNumber
      parameters:
      - name: homeCountry
        in: query
        required: false
        description: 'ISO 3166 alpha2 code of the home country to be used if it is impossible to determine country from the number itself.

          By default, this parameter is preset to the current user''s home country or brand country if the user is undefined

          '
        schema:
          type: string
          example: US
      - name: nationalAsPriority
        in: query
        required: false
        description: 'The default value is `false`. If `true`, the numbers that are

          closer to the home country are given higher priority

          '
        schema:
          type: boolean
          default: false
      requestBody:
        description: Phone number list to parse
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ParsePhoneNumberRequest'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ParsePhoneNumberResponse'
        '400':
          $ref: '#/components/responses/InvalidRequest'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceNotAvailable'
      x-availability: High
      x-throttling-group: Light
components:
  schemas:
    DeletePhoneNumbersResponseItem:
      allOf:
      - $ref: '#/components/schemas/BulkItemResultModel'
      - type: object
        properties:
          id:
            $ref: '#/components/schemas/PhoneNumberId'
          phoneNumber:
            $ref: '#/components/schemas/PhoneNumberE164'
    PhoneNumberUsageType:
      type: string
      description: Usage type of phone number
      enum:
      - MainCompanyNumber
      - DirectNumber
      - Inventory
      - InventoryPartnerBusinessMobileNumber
      - PartnerBusinessMobileNumber
      - AdditionalCompanyNumber
      - CompanyNumber
      - PhoneLine
      - CompanyFaxNumber
      - ForwardedNumber
      - ForwardedCompanyNumber
      - ContactCenterNumber
      - ConferencingNumber
      - MeetingsNumber
      - BusinessMobileNumber
      - ELIN
    PhoneNumberInfoNumberParser:
      type: object
      properties:
        originalString:
          type: string
          description: Original phone number string as it was passed in the request
          example: (650) 722-1621
        country:
          $ref: '#/components/schemas/GetCountryInfoNumberParser'
        areaCode:
          type: string
          description: 'Area code of location. The portion of the [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I)

            number that identifies a specific geographic region/numbering area of

            the national numbering plan (NANP); that can be summarized as `NPA-NXX-xxxx`

            and covers Canada, the United States, parts of the Caribbean Sea, and

            some Atlantic and Pacific islands.

            See [North American Numbering Plan](https://en.wikipedia.org/wiki/North_American_Numbering_Plan)

            for details

            '
          example: '650'
        dialable:
          type: string
          description: Dialing format of a phone number
        e164:
          type: string
          description: Phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) format
        formattedInternational:
          type: string
          description: The formatted phone number string in international format
        formattedNational:
          type: string
          description: The formatted phone number string in domestic format
        special:
          type: boolean
          description: Indicates if the number is in a special format (for example N11 code)'
        normalized:
          type: string
          description: Phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) format without plus sign ('+')
        tollFree:
          type: boolean
          description: Indicates if the number is toll free
        subAddress:
          type: string
          description: Sub-Address. The portion of the number that identifies a subscriber into the subscriber internal (non-public) network.
        subscriberNumber:
          type: string
          description: Subscriber number. The portion of the [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) number that identifies a subscriber in a network or numbering area.
        dtmfPostfix:
          type: string
          description: DTMF (Dual Tone Multi-Frequency) postfix
    AddPhoneNumbersRequest:
      type: object
      required:
      - records
      properties:
        records:
          type: array
          minItems: 1
          description: List of account phone numbers
          items:
            $ref: '#/components/schemas/AddPhoneNumberRequestItem'
    AccountPhoneNumberList:
      type: object
      required:
      - records
      - paging
      properties:
        records:
          type: array
          description: List of account phone numbers
          items:
            $ref: '#/components/schemas/AccountPhoneNumberInfo'
        paging:
          $ref: '#/components/schemas/EnumeratedPagingModel'
    AddPhoneNumbersTask:
      type: object
      properties:
        id:
          type: string
          description: Internal identifier of a task
        creationTime:
          type: string
          format: date-time
          description: Task creation time in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format
        status:
          type: string
          description: Task status
          example: Accepted
    ExtensionStatus:
      type: string
      description: Extension status
      enum:
      - Enabled
      - Disabled
      - Frozen
      - NotActivated
      - Unassigned
    AssignPhoneNumberRequest:
      type: object
      required:
      - usageType
      properties:
        type:
          $ref: '#/components/schemas/PhoneNumberType'
        usageType:
          type: string
          description: Target usage type of phone number (only listed values are supported)
          enum:
          - MainCompanyNumber
          - CompanyNumber
          - DirectNumber
          - PhoneLine
        extension:
          type: object
          required:
          - id
          properties:
            id:
              type: string
              description: Internal identifier of an extension
        costCenterId:
          type: string
    PhoneNumberE164:
      type: string
      pattern: ^\+[1-9]\d{1,14}$
      description: Phone number in e.164 format (with '+' prefix)
      maxLength: 18
      example: '+16501234567'
    BulkItemResultModel:
      type: object
      required:
      - bulkItemSuccessful
      properties:
        bulkItemSuccessful:
          type: boolean
          description: 'Indicates if this item was processed successfully during bulk operation.

            If false, `bulkItemErrors` attribute contains the list of errors

            '
          example: true
        bulkItemErrors:
          type: array
          description: 'The list of errors occurred during processing of particular item of bulk operation.

            Returned only if `bulkItemSuccessful` is false

            '
          minItems: 1
          items:
            $ref: '#/components/schemas/ApiError'
    CountryInfoBasicModel:
      allOf:
      - $ref: '#/components/schemas/CountryInfoMinimalModel'
      - type: object
        properties:
          name:
            type: string
            description: The official name of a country
    DeletePhoneNumbersRequestItem:
      type: object
      description: The indication of a number to be deleted - either "id" or "phoneNumber" must be specified.
      properties:
        id:
          $ref: '#/components/schemas/PhoneNumberId'
        phoneNumber:
          $ref: '#/components/schemas/PhoneNumberE164'
    UserPhoneNumberInfo:
      type: object
      properties:
        uri:
          type: string
          format: uri
          description: Link to the user phone number resource
        id:
          type: integer
          format: int64
          description: Internal identifier of a phone number
        country:
          $ref: '#/components/schemas/CountryInfoBasicModel'
        contactCenterProvider:
          $ref: '#/components/schemas/ContactCenterProvider'
        extension:
          $ref: '#/components/schemas/UserPhoneNumberExtensionInfo'
        label:
          type: string
          description: Custom user-defined name of a phone number, if any
        location:
          type: string
          description: Location (City, State). Filled for local US numbers
        paymentType:
          $ref: '#/components/schemas/PlatformPaymentType'
        phoneNumber:
          type: string
          description: Phone number
        primary:
          type: boolean
          description: 'Indicates if a phone number is primary, i.e. displayed as ''main number'' and called by default

            '
          example: false
        status:
          type: string
          description: 'Status of a phone number. If the value is ''Normal'', the phone

            number is ready to be used. Otherwise, it is an external number not yet

            ported to RingCentral

            '
          enum:
          - Normal
          - Pending
          - PortedIn
          - Temporary
        type:
          type: string
          description: Phone number type
          enum:
          - VoiceFax
          - FaxOnly
          - VoiceOnly
        subType:
          type: string
          description: 'Extension subtype, if applicable. For any unsupported subtypes the ''Unknown'' value will be returned

            '
          enum:
          - VideoPro
          - VideoProPlus
          - DigitalSignage
          - Unknown
          - Emergency
        usageType:
          type: string
          description: 'Usage type of phone number. Numbers of ''NumberPool'' type will not be returned for phone number list requests

            '
          enum:
          - MainCompanyNumber
          - AdditionalCompanyNumber
          - CompanyNumber
          - DirectNumber
          - CompanyFaxNumber
          - ForwardedNumber
          - ForwardedCompanyNumber
          - ContactCenterNumber
          - ConferencingNumber
          - NumberPool
          - BusinessMobileNumber
          - PartnerBusinessMobileNumber
          - IntegrationNumber
        features:
          type: array
          description: List of features of a phone number
          items:
            type: string
            enum:
            - CallerId
            - SmsSender
            - A2PSmsSender
            - MmsSender
            - InternationalSmsSender
            - Delegated
    ParsePhoneNumberRequest:
      type: object
      properties:
        originalStrings:
          type: array
          description: The list of phone numbers passed as an array of strings (not more than 64 items). The maximum size of each string is 64 characters
          maxItems: 64
          items:
            type: string
            maxLength: 64
            example: (650) 722-1621
    PhoneNumberId:
      type: string
      pattern: ^[1-9]\d{1,14}$
      description: Internal unique identifier of a phone number
      maxLength: 18
      example: '1162820004'
    ParameterizedErrorResponseModel:
      type: object
      description: Standard error response which may include parameterized errors
      required:
      - errors
      properties:
        errors:
          type: array
          description: The array of errors (there will be just one in the most of the cases)
          minItems: 1
          items:
            $ref: '#/components/schemas/ApiErrorWithParameter'
    CountryInfoMinimalModel:
      type: object
      properties:
        id:
          type: string
          description: Internal identifier of a country
        uri:
          type: string
          format: uri
          description: Canonical URI of a country resource
    UserPhoneNumberExtensionInfo:
      type: object
      properties:
        id:
          type: integer
          format: int64
          description: Internal identifier of an extension
        uri:
          type: string
          format: uri
          description: Canonical URI of an extension
        extensionNumber:
          type: string
          description: Extension short number
        partnerId:
          type: string
          description: 'For Partner Applications Internal identifier of an extension

            created by partner. The RingCentral supports the mapping of accounts and

            stores the corresponding account ID/extension ID for each partner ID of

            a client application. In request URIs partner IDs are accepted instead

            of regular RingCentral native IDs as path parameters using `pid=XXX` clause.

            Though in response URIs contain the corresponding account IDs and extension

            IDs. In all request and response bodies these values are reflected via

            partnerId attributes of account and extension

            '
        type:
          type: string
          description: 'Extension type. Please note that legacy ''Department'' extension type

            corresponds to ''Call Queue'' extensions in modern RingCentral product terminology

            '
          enum:
          - User
          - FaxUser
          - VirtualUser
          -

# --- truncated at 32 KB (57 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ringcentral/refs/heads/main/openapi/ringcentral-phone-numbers-api-openapi.yml