components:
  schemas:
    numbers.v2.authorization_document:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^PX[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies this AuthorizationDocument.
        address_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AD[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies the Address
            resource that is associated with this AuthorizationDocument.
        status:
          type: string
          $ref: '#/components/schemas/authorization_document_enum_status'
          nullable: true
          description: 'Status of an instance resource. It can hold one of the values:
            1. opened 2. signing, 3. signed LOA, 4. canceled, 5. failed. See the section
            entitled [Status Values](https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/authorization-document-resource#status-values)
            for more information on each of these statuses.'
        email:
          type: string
          nullable: true
          description: Email that this AuthorizationDocument will be sent to for signing.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        cc_emails:
          type: array
          items:
            type: string
          nullable: true
          description: Email recipients who will be informed when an Authorization
            Document has been sent and signed.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        date_created:
          type: string
          format: date-time
          nullable: true
          description: The date this resource was created, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt)
            format.
        date_updated:
          type: string
          format: date-time
          nullable: true
          description: The date that this resource was updated, given as [GMT RFC
            2822](http://www.ietf.org/rfc/rfc2822.txt) format.
        url:
          type: string
          format: uri
          nullable: true
        links:
          type: object
          format: uri-map
          nullable: true
    authorization_document_enum_status:
      type: string
      enum:
      - opened
      - signing
      - signed
      - canceled
      - failed
    numbers.v2.bulk_hosted_number_order:
      type: object
      properties:
        bulk_hosting_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BH[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies this BulkHostedNumberOrder.
        request_status:
          type: string
          $ref: '#/components/schemas/bulk_hosted_number_order_enum_request_status'
          nullable: true
          description: 'A string that shows the status of the current Bulk Hosting
            request, it can vary between these values: ''QUEUED'',''IN_PROGRESS'',''PROCESSED'''
        friendly_name:
          type: string
          nullable: true
          description: A 128 character string that is a human-readable text that describes
            this resource.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        notification_email:
          type: string
          nullable: true
          description: Email address used for send notifications about this Bulk hosted
            number request.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        date_created:
          type: string
          format: date-time
          nullable: true
          description: The date this resource was created, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt)
            format.
        date_completed:
          type: string
          format: date-time
          nullable: true
          description: The date that this resource was completed, given as [GMT RFC
            2822](http://www.ietf.org/rfc/rfc2822.txt) format.
        url:
          type: string
          format: uri
          nullable: true
          description: The URL of this BulkHostedNumberOrder resource.
        total_count:
          type: integer
          nullable: true
          description: The total count of phone numbers in this Bulk hosting request.
        results:
          type: array
          items: {}
          nullable: true
          description: Contains a list of all the individual hosting orders and their
            information, for this Bulk request. Each result object is grouped by its
            order status. To see a complete list of order status, please check 'https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/hosted-number-order-resource#status-values'.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
    bulk_hosted_number_order_enum_request_status:
      type: string
      enum:
      - QUEUED
      - IN_PROGRESS
      - PROCESSED
    numbers.v2.regulatory_compliance.bundle:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string that we created to identify the Bundle resource.
        account_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          nullable: true
          description: The SID of the [Account](https://www.twilio.com/docs/iam/api/account)
            that created the Bundle resource.
        regulation_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^RN[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string of a regulation that is associated to the
            Bundle resource.
        friendly_name:
          type: string
          nullable: true
          description: The string that you assigned to describe the resource.
        status:
          type: string
          $ref: '#/components/schemas/bundle_enum_status'
          nullable: true
          description: The verification status of the Bundle resource.
        valid_until:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
            format when the resource will be valid until.
        email:
          type: string
          nullable: true
          description: The email address that will receive updates when the Bundle
            resource changes status.
        status_callback:
          type: string
          format: uri
          nullable: true
          description: The URL we call to inform your application of status changes.
        date_created:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT when the resource was created specified
            in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        date_updated:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT when the resource was last updated
            specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        url:
          type: string
          format: uri
          nullable: true
          description: The absolute URL of the Bundle resource.
        links:
          type: object
          format: uri-map
          nullable: true
          description: The URLs of the Assigned Items of the Bundle resource.
    bundle_enum_status:
      type: string
      enum:
      - draft
      - pending-review
      - in-review
      - twilio-rejected
      - twilio-approved
      - provisionally-approved
    bundle_enum_end_user_type:
      type: string
      enum:
      - individual
      - business
    bundle_enum_sort_by:
      type: string
      enum:
      - valid-until
      - date-updated
    bundle_enum_sort_direction:
      type: string
      enum:
      - ASC
      - DESC
    numbers.v2.regulatory_compliance.bundle.bundle_copy:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string that we created to identify the Bundle resource.
        account_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          nullable: true
          description: The SID of the [Account](https://www.twilio.com/docs/iam/api/account)
            that created the Bundle resource.
        regulation_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^RN[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string of a regulation that is associated to the
            Bundle resource.
        friendly_name:
          type: string
          nullable: true
          description: The string that you assigned to describe the resource.
        status:
          type: string
          $ref: '#/components/schemas/bundle_copy_enum_status'
          nullable: true
          description: The verification status of the Bundle resource.
        valid_until:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
            format when the resource will be valid until.
        email:
          type: string
          nullable: true
          description: The email address that will receive updates when the Bundle
            resource changes status.
        status_callback:
          type: string
          format: uri
          nullable: true
          description: The URL we call to inform your application of status changes.
        date_created:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT when the resource was created specified
            in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        date_updated:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT when the resource was last updated
            specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    bundle_copy_enum_status:
      type: string
      enum:
      - draft
      - pending-review
      - in-review
      - twilio-rejected
      - twilio-approved
      - provisionally-approved
    bundle_copy_enum_end_user_type:
      type: string
      enum:
      - individual
      - business
    numbers.v2.authorization_document.dependent_hosted_number_order:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^HR[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies this Authorization
            Document
        bulk_hosting_request_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BH[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies the bulk hosting
            request associated with this HostedNumberOrder.
        next_step:
          type: string
          nullable: true
          description: The next step you need to take to complete the hosted number
            order and request it successfully.
        account_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          nullable: true
          description: The unique SID identifier of the Account.
        incoming_phone_number_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^PN[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies the IncomingPhoneNumber
            resource created by this HostedNumberOrder.
        address_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AD[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies the Address
            resource that represents the address of the owner of this phone number.
        signing_document_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^PX[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies the LOA document
            associated with this HostedNumberOrder.
        phone_number:
          type: string
          format: phone-number
          nullable: true
          description: An E164 formatted phone number hosted by this HostedNumberOrder.
        capabilities:
          type: object
          format: phone-number-capabilities
          properties:
            mms:
              type: boolean
            sms:
              type: boolean
            voice:
              type: boolean
            fax:
              type: boolean
          nullable: true
          description: A mapping of capabilities this hosted phone number will have
            enabled on Twilio's platform.
        friendly_name:
          type: string
          nullable: true
          description: A human readable description of this resource, up to 128 characters.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        status:
          type: string
          $ref: '#/components/schemas/dependent_hosted_number_order_enum_status'
          nullable: true
          description: 'Status of an instance resource. It can hold one of the values:
            1. opened 2. signing, 3. signed LOA, 4. canceled, 5. failed. See the section
            entitled [Status Values](https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/authorization-document-resource#status-values)
            for more information on each of these statuses.'
        failure_reason:
          type: string
          nullable: true
          description: A message that explains why a hosted_number_order went to status
            "action-required"
        date_created:
          type: string
          format: date-time
          nullable: true
          description: The date this resource was created, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt)
            format.
        date_updated:
          type: string
          format: date-time
          nullable: true
          description: The date that this resource was updated, given as [GMT RFC
            2822](http://www.ietf.org/rfc/rfc2822.txt) format.
        email:
          type: string
          nullable: true
          description: Email of the owner of this phone number that is being hosted.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        cc_emails:
          type: array
          items:
            type: string
          nullable: true
          description: Email recipients who will be informed when an Authorization
            Document has been sent and signed
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        contact_title:
          type: string
          nullable: true
          description: The title of the person authorized to sign the Authorization
            Document for this phone number.
        contact_phone_number:
          type: string
          format: phone-number
          nullable: true
          description: The contact phone number of the person authorized to sign the
            Authorization Document.
    dependent_hosted_number_order_enum_status:
      type: string
      enum:
      - received
      - verified
      - pending-loa
      - carrier-processing
      - completed
      - failed
      - action-required
    numbers.v2.regulatory_compliance.end_user:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^IT[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string created by Twilio to identify the End User
            resource.
        account_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          nullable: true
          description: The SID of the [Account](https://www.twilio.com/docs/iam/api/account)
            that created the End User resource.
        friendly_name:
          type: string
          nullable: true
          description: The string that you assigned to describe the resource.
        type:
          type: string
          $ref: '#/components/schemas/end_user_enum_type'
          nullable: true
          description: The type of end user of the Bundle resource - can be `individual`
            or `business`.
        attributes:
          nullable: true
          description: The set of parameters that are the attributes of the End Users
            resource which are listed in the End User Types.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        date_created:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT when the resource was created specified
            in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        date_updated:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT when the resource was last updated
            specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        url:
          type: string
          format: uri
          nullable: true
          description: The absolute URL of the End User resource.
    end_user_enum_type:
      type: string
      enum:
      - individual
      - business
    numbers.v2.regulatory_compliance.end_user_type:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^OY[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string that identifies the End-User Type resource.
        friendly_name:
          type: string
          nullable: true
          description: A human-readable description that is assigned to describe the
            End-User Type resource. Examples can include first name, last name, email,
            business name, etc
        machine_name:
          type: string
          nullable: true
          description: A machine-readable description of the End-User Type resource.
            Examples can include first_name, last_name, email, business_name, etc.
        fields:
          type: array
          items: {}
          nullable: true
          description: The required information for creating an End-User. The required
            fields will change as regulatory needs change and will differ for businesses
            and individuals.
        url:
          type: string
          format: uri
          nullable: true
          description: The absolute URL of the End-User Type resource.
    numbers.v2.regulatory_compliance.bundle.evaluation:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^EL[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string that identifies the Evaluation resource.
        account_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          nullable: true
          description: The SID of the [Account](https://www.twilio.com/docs/iam/api/account)
            that created the Bundle resource.
        regulation_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^RN[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string of a regulation that is associated to the
            Bundle resource.
        bundle_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string that we created to identify the Bundle resource.
        status:
          type: string
          $ref: '#/components/schemas/evaluation_enum_status'
          nullable: true
          description: The compliance status of the Evaluation resource.
        results:
          type: array
          items: {}
          nullable: true
          description: The results of the Evaluation which includes the valid and
            invalid attributes.
        date_created:
          type: string
          format: date-time
          nullable: true
        url:
          type: string
          format: uri
          nullable: true
    evaluation_enum_status:
      type: string
      enum:
      - compliant
      - noncompliant
    numbers.v2.hosted_number_order:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^HR[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies this HostedNumberOrder.
        account_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies the account.
        incoming_phone_number_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^PN[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies the [IncomingPhoneNumber](https://www.twilio.com/docs/phone-numbers/api/incomingphonenumber-resource)
            resource that represents the phone number being hosted.
        address_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AD[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies the Address
            resource that represents the address of the owner of this phone number.
        signing_document_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^PX[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies the [Authorization
            Document](https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/authorization-document-resource)
            the user needs to sign.
        phone_number:
          type: string
          format: phone-number
          nullable: true
          description: Phone number to be hosted. This must be in [E.164](https://en.wikipedia.org/wiki/E.164)
            format, e.g., +16175551212
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        capabilities:
          type: object
          format: phone-number-capabilities
          properties:
            mms:
              type: boolean
            sms:
              type: boolean
            voice:
              type: boolean
            fax:
              type: boolean
          nullable: true
          description: Set of booleans describing the capabilities hosted on Twilio's
            platform. SMS is currently only supported.
        friendly_name:
          type: string
          nullable: true
          description: A 128 character string that is a human-readable text that describes
            this resource.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        status:
          type: string
          $ref: '#/components/schemas/hosted_number_order_enum_status'
          nullable: true
          description: 'Status of this resource. It can hold one of the values: 1.
            Twilio Processing 2. Received, 3. Pending LOA, 4. Carrier Processing,
            5. Completed, 6. Action Required, 7. Failed. See the [HostedNumberOrders
            Status Values](https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/hosted-number-order-resource#status-values)
            section for more information on each of these statuses.'
        failure_reason:
          type: string
          nullable: true
          description: A message that explains why a hosted_number_order went to status
            "action-required"
        date_created:
          type: string
          format: date-time
          nullable: true
          description: The date this resource was created, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt)
            format.
        date_updated:
          type: string
          format: date-time
          nullable: true
          description: The date that this resource was updated, given as [GMT RFC
            2822](http://www.ietf.org/rfc/rfc2822.txt) format.
        email:
          type: string
          nullable: true
          description: Email of the owner of this phone number that is being hosted.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        cc_emails:
          type: array
          items:
            type: string
          nullable: true
          description: A list of emails that LOA document for this HostedNumberOrder
            will be carbon copied to.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        url:
          type: string
          format: uri
          nullable: true
          description: The URL of this HostedNumberOrder.
        contact_title:
          type: string
          nullable: true
          description: The title of the person authorized to sign the Authorization
            Document for this phone number.
        contact_phone_number:
          type: string
          format: phone-number
          nullable: true
          description: The contact phone number of the person authorized to sign the
            Authorization Document.
        bulk_hosting_request_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BH[0-9a-fA-F]{32}$
          nullable: true
          description: A 34 character string that uniquely identifies the bulk hosting
            request associated with this HostedNumberOrder.
        next_step:
          type: string
          nullable: true
          description: The next step you need to take to complete the hosted number
            order and request it successfully.
    hosted_number_order_enum_status:
      type: string
      enum:
      - received
      - verified
      - pending-loa
      - carrier-processing
      - completed
      - failed
      - action-required
    numbers.v2.regulatory_compliance.bundle.item_assignment:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BV[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string that we created to identify the Item Assignment
            resource.
        bundle_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string that we created to identify the Bundle resource.
        account_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          nullable: true
          description: The SID of the [Account](https://www.twilio.com/docs/iam/api/account)
            that created the Item Assignment resource.
        object_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^[a-zA-Z]{2}[0-9a-fA-F]{32}$
          nullable: true
          description: The SID of an object bag that holds information of the different
            items.
        date_created:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT when the resource was created specified
            in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        url:
          type: string
          format: uri
          nullable: true
          description: The absolute URL of the Identity resource.
    numbers.v2.regulatory_compliance.regulation:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^RN[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string that identifies the Regulation resource.
        friendly_name:
          type: string
          nullable: true
          description: 'A human-readable description that is assigned to describe
            the Regulation resource. Examples can include Germany: Mobile - Business.'
        iso_country:
          type: string
          nullable: true
          description: The ISO country code of the phone number's country.
        number_type:
          type: string
          nullable: true
          description: The type of phone number restricted by the regulatory requirement.
            For example, Germany mobile phone numbers provisioned by businesses require
            a business name with commercial register proof from the Handelsregisterauszug
            and a proof of address from Handelsregisterauszug or a trade license by
            Gewerbeanmeldung.
        end_user_type:
          type: string
          $ref: '#/components/schemas/regulation_enum_end_user_type'
          nullable: true
          description: The type of End User the regulation requires - can be `individual`
            or `business`.
        requirements:
          nullable: true
          description: The SID of an object that holds the regulatory information
            of the phone number country, phone number type, and end user type.
        url:
          type: string
          format: uri
          nullable: true
          description: The absolute URL of the Regulation resource.
    regulation_enum_end_user_type:
      type: string
      enum:
      - individual
      - business
    numbers.v2.regulatory_compliance:
      type: object
      properties: {}
    numbers.v2.regulatory_compliance.bundle.replace_items:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string that we created to identify the Bundle resource.
        account_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          nullable: true
          description: The SID of the [Account](https://www.twilio.com/docs/iam/api/account)
            that created the Bundle resource.
        regulation_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^RN[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string of a regulation that is associated to the
            Bundle resource.
        friendly_name:
          type: string
          nullable: true
          description: The string that you assigned to describe the resource.
        status:
          type: string
          $ref: '#/components/schemas/replace_items_enum_status'
          nullable: true
          description: The verification status of the Bundle resource.
        valid_until:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
            format when the resource will be valid until.
        email:
          type: string
          nullable: true
          description: The email address that will receive updates when the Bundle
            resource changes status.
        status_callback:
          type: string
          format: uri
          nullable: true
          description: The URL we call to inform your application of status changes.
        date_created:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT when the resource was created specified
            in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        date_updated:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT when the resource was last updated
            specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    replace_items_enum_status:
      type: string
      enum:
      - draft
      - pending-review
      - in-review
      - twilio-rejected
      - twilio-approved
      - provisionally-approved
    replace_items_enum_end_user_type:
      type: string
      enum:
      - individual
      - business
    numbers.v2.regulatory_compliance.supporting_document:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^RD[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string created by Twilio to identify the Supporting
            Document resource.
        account_sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          nullable: true
          description: The SID of the [Account](https://www.twilio.com/docs/iam/api/account)
            that created the Document resource.
        friendly_name:
          type: string
          nullable: true
          description: The string that you assigned to describe the resource.
        mime_type:
          type: string
          nullable: true
          description: The image type uploaded in the Supporting Document container.
        status:
          type: string
          $ref: '#/components/schemas/supporting_document_enum_status'
          nullable: true
          description: The verification status of the Supporting Document resource.
        failure_reason:
          type: string
          nullable: true
          description: The failure reason of the Supporting Document Resource.
        type:
          type: string
          nullable: true
          description: The type of the Supporting Document.
        attributes:
          nullable: true
          description: The set of parameters that are the attributes of the Supporting
            Documents resource which are listed in the Supporting Document Types.
          x-twilio:
            pii:
              handling: standard
              deleteSla: 30
        date_created:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT when the resource was created specified
            in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        date_updated:
          type: string
          format: date-time
          nullable: true
          description: The date and time in GMT when the resource was last updated
            specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        url:
          type: string
          format: uri
          nullable: true
          description: The absolute URL of the Supporting Document resource.
    supporting_document_enum_status:
      type: string
      enum:
      - draft
      - pending-review
      - rejected
      - approved
      - expired
      - provisionally-approved
    numbers.v2.regulatory_compliance.supporting_document_type:
      type: object
      properties:
        sid:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^OY[0-9a-fA-F]{32}$
          nullable: true
          description: The unique string that identifies the Supporting Document Type
            resource.
        friendly_name:
          type: string
          nullable: true
          description: A human-readable description of the Supporting Document Type
            resource.
        machine_name:
          type: string
          nullable: true
          description: The machine-readable description of the Supporting Document
            Type resource.
        fields:
          type: array
          items: {}
          nullable: true
          description: The required information for creating a Supporting Document.
            The required fields will change as regulatory needs change and will differ
            for businesses and individuals.
        url:
          type: string
          format: uri
          nullable: true
          description: The absolute URL of the Supporting Document Type resource.
  securitySchemes:
    accountSid_authToken:
      type: http
      scheme: basic
info:
  title: Twilio - Numbers
  description: This is the public Twilio REST API.
  termsOfService: https://www.twilio.com/legal/tos
  contact:
    name: Twilio Support
    url: https://support.twilio.com
    email: support@twilio.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 1.55.4
openapi: 3.0.1
paths:
  /v2/HostedNumber/AuthorizationDocuments/{Sid}:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      dependentProperties:
        dependent_hosted_number_orders:
          mapping:
            signing_document_sid: sid
          resource_url: /v2/HostedNumber/AuthorizationDocuments/{signing_document_sid}/DependentHostedNumberOrders
    get:
      description: Fetch a specific AuthorizationDocument.
      tags:
      - NumbersV2AuthorizationDocument
      parameters:
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this AuthorizationDocument.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^PX[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.authorization_document'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchAuthorizationDocument
      x-maturity:
      - Beta
    delete:
      description: Cancel the AuthorizationDocument request.
      tags:
      - NumbersV2AuthorizationDocument
      parameters:
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this AuthorizationDocument.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^PX[0-9a-fA-F]{32}$
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteAuthorizationDocument
      x-maturity:
      - Beta
  /v2/HostedNumber/AuthorizationDocuments:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
      dependentProperties:
        dependent_hosted_number_orders:
          mapping:
            signing_document_sid: sid
          resource_url: /v2/HostedNumber/AuthorizationDocuments/{signing_document_sid}/DependentHostedNumberOrders
    get:
      description: Retrieve a list of AuthorizationDocuments belonging to the account
        initiating the request.
      tags:
      - NumbersV2AuthorizationDocument
      parameters:
      - name: Email
        in: query
        description: Email that this AuthorizationDocument will be sent to for signing.
        schema:
          type: string
        x-twilio:
          pii:
            handling: standard
            deleteSla: 30
      - name: Status
        in: query
        description: 'Status of an instance resource. It can hold one of the values:
          1. opened 2. signing, 3. signed LOA, 4. canceled, 5. failed. See the section
          entitled [Status Values](https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/authorization-document-resource#status-values)
          for more information on each of these statuses.'
        schema:
          type: string
          $ref: '#/components/schemas/authorization_document_enum_status'
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListAuthorizationDocumentResponse
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.authorization_document'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListAuthorizationDocument
      x-maturity:
      - Beta
    post:
      description: Create an AuthorizationDocument for authorizing the hosting of
        phone number capabilities on Twilio's platform.
      tags:
      - NumbersV2AuthorizationDocument
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.authorization_document'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateAuthorizationDocument
      x-maturity:
      - Beta
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              title: CreateAuthorizationDocumentRequest
              properties:
                AddressSid:
                  type: string
                  minLength: 34
                  maxLength: 34
                  pattern: ^AD[0-9a-fA-F]{32}$
                  description: A 34 character string that uniquely identifies the
                    Address resource that is associated with this AuthorizationDocument.
                Email:
                  type: string
                  description: Email that this AuthorizationDocument will be sent
                    to for signing.
                ContactPhoneNumber:
                  type: string
                  format: phone-number
                  description: The contact phone number of the person authorized to
                    sign the Authorization Document.
                HostedNumberOrderSids:
                  type: array
                  items:
                    type: string
                  description: A list of HostedNumberOrder sids that this AuthorizationDocument
                    will authorize for hosting phone number capabilities on Twilio's
                    platform.
                ContactTitle:
                  type: string
                  description: The title of the person authorized to sign the Authorization
                    Document for this phone number.
                CcEmails:
                  type: array
                  items:
                    type: string
                  description: Email recipients who will be informed when an Authorization
                    Document has been sent and signed.
              required:
              - AddressSid
              - Email
              - ContactPhoneNumber
              - HostedNumberOrderSids
  /v2/HostedNumber/Orders/Bulk/{BulkHostingSid}:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      mountName: bulk_hosted_number_orders
    get:
      description: Fetch a specific BulkHostedNumberOrder.
      tags:
      - NumbersV2BulkHostedNumberOrder
      parameters:
      - name: BulkHostingSid
        in: path
        description: A 34 character string that uniquely identifies this BulkHostedNumberOrder.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BH[0-9a-fA-F]{32}$
        required: true
      - name: OrderStatus
        in: query
        description: Order status can be used for filtering on Hosted Number Order
          status values. To see a complete list of order statuses, please check 'https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/hosted-number-order-resource#status-values'.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.bulk_hosted_number_order'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchBulkHostedNumberOrder
      x-maturity:
      - Beta
  /v2/HostedNumber/Orders/Bulk:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
      mountName: bulk_hosted_number_orders
  /v2/RegulatoryCompliance/Bundles:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - regulation_sid
      - friendly_name
      pathType: list
      dependentProperties:
        evaluations:
          mapping:
            bundle_sid: sid
          resource_url: /v2/RegulatoryCompliance/Bundles/{bundle_sid}/Evaluations
        item_assignments:
          mapping:
            bundle_sid: sid
          resource_url: /v2/RegulatoryCompliance/Bundles/{bundle_sid}/ItemAssignments
        bundle_copies:
          mapping:
            bundle_sid: sid
          resource_url: /v2/RegulatoryCompliance/Bundles/{bundle_sid}/Copies
        replace_items:
          mapping:
            bundle_sid: sid
          resource_url: /v2/RegulatoryCompliance/Bundles/{bundle_sid}/ReplaceItems
      parent: /RegulatoryCompliance
    post:
      description: Create a new Bundle.
      tags:
      - NumbersV2Bundle
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateBundle
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              title: CreateBundleRequest
              properties:
                FriendlyName:
                  type: string
                  description: The string that you assigned to describe the resource.
                Email:
                  type: string
                  description: The email address that will receive updates when the
                    Bundle resource changes status.
                StatusCallback:
                  type: string
                  format: uri
                  description: The URL we call to inform your application of status
                    changes.
                RegulationSid:
                  type: string
                  minLength: 34
                  maxLength: 34
                  pattern: ^RN[0-9a-fA-F]{32}$
                  description: The unique string of a regulation that is associated
                    to the Bundle resource.
                IsoCountry:
                  type: string
                  description: The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
                    of the Bundle's phone number country ownership request.
                EndUserType:
                  type: string
                  $ref: '#/components/schemas/bundle_enum_end_user_type'
                  description: The [type of End User](https://www.twilio.com/docs/phone-numbers/regulatory/api/end-user-types)
                    of the Bundle resource.
                NumberType:
                  type: string
                  description: The type of phone number of the Bundle's ownership
                    request. Can be `local`, `mobile`, `national`, or `toll free`.
              required:
              - FriendlyName
              - Email
    get:
      description: Retrieve a list of all Bundles for an account.
      tags:
      - NumbersV2Bundle
      parameters:
      - name: Status
        in: query
        description: The verification status of the Bundle resource. Please refer
          to [Bundle Statuses](https://www.twilio.com/docs/phone-numbers/regulatory/api/bundles#bundle-statuses)
          for more details.
        schema:
          type: string
          $ref: '#/components/schemas/bundle_enum_status'
      - name: FriendlyName
        in: query
        description: The string that you assigned to describe the resource. The column
          can contain 255 variable characters.
        schema:
          type: string
      - name: RegulationSid
        in: query
        description: The unique string of a [Regulation resource](https://www.twilio.com/docs/phone-numbers/regulatory/api/regulations)
          that is associated to the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^RN[0-9a-fA-F]{32}$
      - name: IsoCountry
        in: query
        description: The 2-digit [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
          of the Bundle's phone number country ownership request.
        schema:
          type: string
      - name: NumberType
        in: query
        description: The type of phone number of the Bundle's ownership request. Can
          be `local`, `mobile`, `national`, or `tollfree`.
        schema:
          type: string
      - name: HasValidUntilDate
        in: query
        description: Indicates that the Bundle is a valid Bundle until a specified
          expiration date.
        schema:
          type: boolean
      - name: SortBy
        in: query
        description: Can be `valid-until` or `date-updated`. Defaults to `date-created`.
        schema:
          type: string
          $ref: '#/components/schemas/bundle_enum_sort_by'
      - name: SortDirection
        in: query
        description: Default is `DESC`. Can be `ASC` or `DESC`.
        schema:
          type: string
          $ref: '#/components/schemas/bundle_enum_sort_direction'
      - name: ValidUntilDate
        in: query
        description: Date to filter Bundles having their `valid_until_date` before
          or after the specified date. Can be `ValidUntilDate>=` or `ValidUntilDate<=`.
          Both can be used in conjunction as well. [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
          is the acceptable date format.
        schema:
          type: string
          format: date-time
      - name: ValidUntilDate<
        in: query
        description: Date to filter Bundles having their `valid_until_date` before
          or after the specified date. Can be `ValidUntilDate>=` or `ValidUntilDate<=`.
          Both can be used in conjunction as well. [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
          is the acceptable date format.
        schema:
          type: string
          format: date-time
      - name: ValidUntilDate>
        in: query
        description: Date to filter Bundles having their `valid_until_date` before
          or after the specified date. Can be `ValidUntilDate>=` or `ValidUntilDate<=`.
          Both can be used in conjunction as well. [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
          is the acceptable date format.
        schema:
          type: string
          format: date-time
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListBundleResponse
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListBundle
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/Bundles/{Sid}:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - regulation_sid
      - friendly_name
      pathType: instance
      dependentProperties:
        evaluations:
          mapping:
            bundle_sid: sid
          resource_url: /v2/RegulatoryCompliance/Bundles/{bundle_sid}/Evaluations
        item_assignments:
          mapping:
            bundle_sid: sid
          resource_url: /v2/RegulatoryCompliance/Bundles/{bundle_sid}/ItemAssignments
        bundle_copies:
          mapping:
            bundle_sid: sid
          resource_url: /v2/RegulatoryCompliance/Bundles/{bundle_sid}/Copies
        replace_items:
          mapping:
            bundle_sid: sid
          resource_url: /v2/RegulatoryCompliance/Bundles/{bundle_sid}/ReplaceItems
      parent: /RegulatoryCompliance
    get:
      description: Fetch a specific Bundle instance.
      tags:
      - NumbersV2Bundle
      parameters:
      - name: Sid
        in: path
        description: The unique string that we created to identify the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchBundle
      x-maturity:
      - GA
    post:
      description: Updates a Bundle in an account.
      tags:
      - NumbersV2Bundle
      parameters:
      - name: Sid
        in: path
        description: The unique string that we created to identify the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateBundle
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              title: UpdateBundleRequest
              properties:
                Status:
                  type: string
                  $ref: '#/components/schemas/bundle_enum_status'
                  description: The verification status of the Bundle resource.
                StatusCallback:
                  type: string
                  format: uri
                  description: The URL we call to inform your application of status
                    changes.
                FriendlyName:
                  type: string
                  description: The string that you assigned to describe the resource.
                Email:
                  type: string
                  description: The email address that will receive updates when the
                    Bundle resource changes status.
      x-twilio:
        addContentTypeIfEmptyForm: true
    delete:
      description: Delete a specific Bundle.
      tags:
      - NumbersV2Bundle
      parameters:
      - name: Sid
        in: path
        description: The unique string that we created to identify the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteBundle
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/Bundles/{BundleSid}/Copies:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
      parent: /RegulatoryCompliance/Bundles/{Sid}
      mountName: bundle_copies
    post:
      description: Creates a new copy of a Bundle. It will internally create copies
        of all the bundle items (identities and documents) of the original bundle
      tags:
      - NumbersV2BundleCopy
      parameters:
      - name: BundleSid
        in: path
        description: The unique string that identifies the Bundle to be copied.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle.bundle_copy'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateBundleCopy
      x-maturity:
      - Beta
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              title: CreateBundleCopyRequest
              properties:
                FriendlyName:
                  type: string
                  description: The string that you assigned to describe the copied
                    bundle.
      x-twilio:
        addContentTypeIfEmptyForm: true
    get:
      description: Retrieve a list of all Bundles Copies for a Bundle.
      tags:
      - NumbersV2BundleCopy
      parameters:
      - name: BundleSid
        in: path
        description: The unique string that we created to identify the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListBundleCopyResponse
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle.bundle_copy'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListBundleCopy
      x-maturity:
      - Beta
  /v2/HostedNumber/AuthorizationDocuments/{SigningDocumentSid}/DependentHostedNumberOrders:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
      parent: /HostedNumber/AuthorizationDocuments/{Sid}
    get:
      description: Retrieve a list of dependent HostedNumberOrders belonging to the
        AuthorizationDocument.
      tags:
      - NumbersV2DependentHostedNumberOrder
      parameters:
      - name: SigningDocumentSid
        in: path
        description: A 34 character string that uniquely identifies the LOA document
          associated with this HostedNumberOrder.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^PX[0-9a-fA-F]{32}$
        required: true
      - name: Status
        in: query
        description: 'Status of an instance resource. It can hold one of the values:
          1. opened 2. signing, 3. signed LOA, 4. canceled, 5. failed. See the section
          entitled [Status Values](https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/authorization-document-resource#status-values)
          for more information on each of these statuses.'
        schema:
          type: string
          $ref: '#/components/schemas/dependent_hosted_number_order_enum_status'
      - name: PhoneNumber
        in: query
        description: An E164 formatted phone number hosted by this HostedNumberOrder.
        schema:
          type: string
          format: phone-number
      - name: IncomingPhoneNumberSid
        in: query
        description: A 34 character string that uniquely identifies the IncomingPhoneNumber
          resource created by this HostedNumberOrder.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^PN[0-9a-fA-F]{32}$
      - name: FriendlyName
        in: query
        description: A human readable description of this resource, up to 128 characters.
        schema:
          type: string
        x-twilio:
          pii:
            handling: standard
            deleteSla: 30
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListDependentHostedNumberOrderResponse
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.authorization_document.dependent_hosted_number_order'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListDependentHostedNumberOrder
      x-maturity:
      - Beta
  /v2/RegulatoryCompliance/EndUsers:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - friendly_name
      pathType: list
      parent: /RegulatoryCompliance
    post:
      description: Create a new End User.
      tags:
      - NumbersV2EndUser
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.end_user'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateEndUser
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              title: CreateEndUserRequest
              properties:
                FriendlyName:
                  type: string
                  description: The string that you assigned to describe the resource.
                Type:
                  type: string
                  $ref: '#/components/schemas/end_user_enum_type'
                  description: The type of end user of the Bundle resource - can be
                    `individual` or `business`.
                Attributes:
                  description: The set of parameters that are the attributes of the
                    End User resource which are derived End User Types.
              required:
              - FriendlyName
              - Type
    get:
      description: Retrieve a list of all End User for an account.
      tags:
      - NumbersV2EndUser
      parameters:
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListEndUserResponse
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.regulatory_compliance.end_user'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListEndUser
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/EndUsers/{Sid}:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - friendly_name
      pathType: instance
      parent: /RegulatoryCompliance
    get:
      description: Fetch specific End User Instance.
      tags:
      - NumbersV2EndUser
      parameters:
      - name: Sid
        in: path
        description: The unique string created by Twilio to identify the End User
          resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^IT[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.end_user'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchEndUser
      x-maturity:
      - GA
    post:
      description: Update an existing End User.
      tags:
      - NumbersV2EndUser
      parameters:
      - name: Sid
        in: path
        description: The unique string created by Twilio to identify the End User
          resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^IT[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.end_user'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateEndUser
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              title: UpdateEndUserRequest
              properties:
                FriendlyName:
                  type: string
                  description: The string that you assigned to describe the resource.
                Attributes:
                  description: The set of parameters that are the attributes of the
                    End User resource which are derived End User Types.
      x-twilio:
        addContentTypeIfEmptyForm: true
    delete:
      description: Delete a specific End User.
      tags:
      - NumbersV2EndUser
      parameters:
      - name: Sid
        in: path
        description: The unique string created by Twilio to identify the End User
          resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^IT[0-9a-fA-F]{32}$
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteEndUser
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/EndUserTypes:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - friendly_name
      pathType: list
      parent: /RegulatoryCompliance
    get:
      description: Retrieve a list of all End-User Types.
      tags:
      - NumbersV2EndUserType
      parameters:
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListEndUserTypeResponse
                properties:
                  end_user_types:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.regulatory_compliance.end_user_type'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListEndUserType
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/EndUserTypes/{Sid}:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - friendly_name
      pathType: instance
      parent: /RegulatoryCompliance
    get:
      description: Fetch a specific End-User Type Instance.
      tags:
      - NumbersV2EndUserType
      parameters:
      - name: Sid
        in: path
        description: The unique string that identifies the End-User Type resource.
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.end_user_type'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchEndUserType
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/Bundles/{BundleSid}/Evaluations:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      pathType: list
      parent: /RegulatoryCompliance/Bundles/{Sid}
    post:
      description: Creates an evaluation for a bundle
      tags:
      - NumbersV2Evaluation
      parameters:
      - name: BundleSid
        in: path
        description: The unique string that identifies the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle.evaluation'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateEvaluation
      x-maturity:
      - GA
    get:
      description: Retrieve a list of Evaluations associated to the Bundle resource.
      tags:
      - NumbersV2Evaluation
      parameters:
      - name: BundleSid
        in: path
        description: The unique string that identifies the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListEvaluationResponse
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle.evaluation'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListEvaluation
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/Bundles/{BundleSid}/Evaluations/{Sid}:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      pathType: instance
      parent: /RegulatoryCompliance/Bundles/{Sid}
    get:
      description: Fetch specific Evaluation Instance.
      tags:
      - NumbersV2Evaluation
      parameters:
      - name: BundleSid
        in: path
        description: The unique string that we created to identify the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      - name: Sid
        in: path
        description: The unique string that identifies the Evaluation resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^EL[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle.evaluation'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchEvaluation
      x-maturity:
      - GA
  /v2/HostedNumber/Orders/{Sid}:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      mountName: hosted_number_orders
    get:
      description: Fetch a specific HostedNumberOrder.
      tags:
      - NumbersV2HostedNumberOrder
      parameters:
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this HostedNumberOrder.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^HR[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.hosted_number_order'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchHostedNumberOrder
      x-maturity:
      - Beta
    delete:
      description: Cancel the HostedNumberOrder (only available when the status is
        in `received`).
      tags:
      - NumbersV2HostedNumberOrder
      parameters:
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this HostedNumberOrder.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^HR[0-9a-fA-F]{32}$
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteHostedNumberOrder
      x-maturity:
      - Beta
  /v2/HostedNumber/Orders:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
      mountName: hosted_number_orders
    get:
      description: Retrieve a list of HostedNumberOrders belonging to the account
        initiating the request.
      tags:
      - NumbersV2HostedNumberOrder
      parameters:
      - name: Status
        in: query
        description: The Status of this HostedNumberOrder. One of `received`, `pending-verification`,
          `verified`, `pending-loa`, `carrier-processing`, `testing`, `completed`,
          `failed`, or `action-required`.
        schema:
          type: string
          $ref: '#/components/schemas/hosted_number_order_enum_status'
      - name: SmsCapability
        in: query
        description: Whether the SMS capability will be hosted on our platform. Can
          be `true` of `false`.
        schema:
          type: boolean
      - name: PhoneNumber
        in: query
        description: An E164 formatted phone number hosted by this HostedNumberOrder.
        schema:
          type: string
          format: phone-number
        x-twilio:
          pii:
            handling: standard
            deleteSla: 30
      - name: IncomingPhoneNumberSid
        in: query
        description: A 34 character string that uniquely identifies the IncomingPhoneNumber
          resource created by this HostedNumberOrder.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^PN[0-9a-fA-F]{32}$
      - name: FriendlyName
        in: query
        description: A human readable description of this resource, up to 128 characters.
        schema:
          type: string
        x-twilio:
          pii:
            handling: standard
            deleteSla: 30
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListHostedNumberOrderResponse
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.hosted_number_order'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListHostedNumberOrder
      x-maturity:
      - Beta
    post:
      description: Host a phone number's capability on Twilio's platform.
      tags:
      - NumbersV2HostedNumberOrder
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.hosted_number_order'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateHostedNumberOrder
      x-maturity:
      - Beta
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              title: CreateHostedNumberOrderRequest
              properties:
                PhoneNumber:
                  type: string
                  format: phone-number
                  description: The number to host in [+E.164](https://en.wikipedia.org/wiki/E.164)
                    format
                ContactPhoneNumber:
                  type: string
                  format: phone-number
                  description: The contact phone number of the person authorized to
                    sign the Authorization Document.
                AddressSid:
                  type: string
                  minLength: 34
                  maxLength: 34
                  pattern: ^AD[0-9a-fA-F]{32}$
                  description: Optional. A 34 character string that uniquely identifies
                    the Address resource that represents the address of the owner
                    of this phone number.
                Email:
                  type: string
                  description: Optional. Email of the owner of this phone number that
                    is being hosted.
                AccountSid:
                  type: string
                  minLength: 34
                  maxLength: 34
                  pattern: ^AC[0-9a-fA-F]{32}$
                  description: This defaults to the AccountSid of the authorization
                    the user is using. This can be provided to specify a subaccount
                    to add the HostedNumberOrder to.
                FriendlyName:
                  type: string
                  description: A 128 character string that is a human readable text
                    that describes this resource.
                CcEmails:
                  type: array
                  items:
                    type: string
                  description: Optional. A list of emails that the LOA document for
                    this HostedNumberOrder will be carbon copied to.
                SmsUrl:
                  type: string
                  format: uri
                  description: The URL that Twilio should request when somebody sends
                    an SMS to the phone number. This will be copied onto the IncomingPhoneNumber
                    resource.
                SmsMethod:
                  type: string
                  format: http-method
                  enum:
                  - HEAD
                  - GET
                  - POST
                  - PATCH
                  - PUT
                  - DELETE
                  description: The HTTP method that should be used to request the
                    SmsUrl. Must be either `GET` or `POST`.  This will be copied onto
                    the IncomingPhoneNumber resource.
                SmsFallbackUrl:
                  type: string
                  format: uri
                  description: A URL that Twilio will request if an error occurs requesting
                    or executing the TwiML defined by SmsUrl. This will be copied
                    onto the IncomingPhoneNumber resource.
                SmsCapability:
                  type: boolean
                  description: Used to specify that the SMS capability will be hosted
                    on Twilio's platform.
                SmsFallbackMethod:
                  type: string
                  format: http-method
                  enum:
                  - HEAD
                  - GET
                  - POST
                  - PATCH
                  - PUT
                  - DELETE
                  description: The HTTP method that should be used to request the
                    SmsFallbackUrl. Must be either `GET` or `POST`. This will be copied
                    onto the IncomingPhoneNumber resource.
                StatusCallbackUrl:
                  type: string
                  format: uri
                  description: Optional. The Status Callback URL attached to the IncomingPhoneNumber
                    resource.
                StatusCallbackMethod:
                  type: string
                  format: http-method
                  enum:
                  - HEAD
                  - GET
                  - POST
                  - PATCH
                  - PUT
                  - DELETE
                  description: Optional. The Status Callback Method attached to the
                    IncomingPhoneNumber resource.
                SmsApplicationSid:
                  type: string
                  minLength: 34
                  maxLength: 34
                  pattern: ^AP[0-9a-fA-F]{32}$
                  description: Optional. The 34 character sid of the application Twilio
                    should use to handle SMS messages sent to this number. If a `SmsApplicationSid`
                    is present, Twilio will ignore all of the SMS urls above and use
                    those set on the application.
                ContactTitle:
                  type: string
                  description: The title of the person authorized to sign the Authorization
                    Document for this phone number.
              required:
              - PhoneNumber
              - ContactPhoneNumber
              - AddressSid
              - Email
  /v2/RegulatoryCompliance/Bundles/{BundleSid}/ItemAssignments:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      pathType: list
      parent: /RegulatoryCompliance/Bundles/{Sid}
    post:
      description: Create a new Assigned Item.
      tags:
      - NumbersV2ItemAssignment
      parameters:
      - name: BundleSid
        in: path
        description: The unique string that we created to identify the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle.item_assignment'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateItemAssignment
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              title: CreateItemAssignmentRequest
              properties:
                ObjectSid:
                  type: string
                  minLength: 34
                  maxLength: 34
                  pattern: ^[a-zA-Z]{2}[0-9a-fA-F]{32}$
                  description: The SID of an object bag that holds information of
                    the different items.
              required:
              - ObjectSid
    get:
      description: Retrieve a list of all Assigned Items for an account.
      tags:
      - NumbersV2ItemAssignment
      parameters:
      - name: BundleSid
        in: path
        description: The unique string that we created to identify the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListItemAssignmentResponse
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle.item_assignment'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListItemAssignment
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/Bundles/{BundleSid}/ItemAssignments/{Sid}:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      pathType: instance
      parent: /RegulatoryCompliance/Bundles/{Sid}
    get:
      description: Fetch specific Assigned Item Instance.
      tags:
      - NumbersV2ItemAssignment
      parameters:
      - name: BundleSid
        in: path
        description: The unique string that we created to identify the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      - name: Sid
        in: path
        description: The unique string that we created to identify the Identity resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BV[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle.item_assignment'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchItemAssignment
      x-maturity:
      - GA
    delete:
      description: Remove an Assignment Item Instance.
      tags:
      - NumbersV2ItemAssignment
      parameters:
      - name: BundleSid
        in: path
        description: The unique string that we created to identify the Bundle resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      - name: Sid
        in: path
        description: The unique string that we created to identify the Identity resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BV[0-9a-fA-F]{32}$
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteItemAssignment
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/Regulations:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - friendly_name
      pathType: list
      parent: /RegulatoryCompliance
    get:
      description: Retrieve a list of all Regulations.
      tags:
      - NumbersV2Regulation
      parameters:
      - name: EndUserType
        in: query
        description: The type of End User the regulation requires - can be `individual`
          or `business`.
        schema:
          type: string
          $ref: '#/components/schemas/regulation_enum_end_user_type'
      - name: IsoCountry
        in: query
        description: The ISO country code of the phone number's country.
        schema:
          type: string
      - name: NumberType
        in: query
        description: The type of phone number that the regulatory requiremnt is restricting.
        schema:
          type: string
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListRegulationResponse
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.regulatory_compliance.regulation'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListRegulation
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/Regulations/{Sid}:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - friendly_name
      pathType: instance
      parent: /RegulatoryCompliance
    get:
      description: Fetch specific Regulation Instance.
      tags:
      - NumbersV2Regulation
      parameters:
      - name: Sid
        in: path
        description: The unique string that identifies the Regulation resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^RN[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.regulation'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchRegulation
      x-maturity:
      - GA
  /v2/RegulatoryCompliance:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
  /v2/RegulatoryCompliance/Bundles/{BundleSid}/ReplaceItems:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
      parent: /RegulatoryCompliance/Bundles/{Sid}
      className: replace_items
    post:
      description: Replaces all bundle items in the target bundle (specified in the
        path) with all the bundle items of the source bundle (specified by the from_bundle_sid
        body param)
      tags:
      - NumbersV2ReplaceItems
      parameters:
      - name: BundleSid
        in: path
        description: The unique string that identifies the Bundle where the item assignments
          are going to be replaced.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^BU[0-9a-fA-F]{32}$
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.bundle.replace_items'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateReplaceItems
      x-maturity:
      - Beta
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              title: CreateReplaceItemsRequest
              properties:
                FromBundleSid:
                  type: string
                  minLength: 34
                  maxLength: 34
                  pattern: ^BU[0-9a-fA-F]{32}$
                  description: The source bundle sid to copy the item assignments
                    from.
              required:
              - FromBundleSid
  /v2/RegulatoryCompliance/SupportingDocuments:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - friendly_name
      pathType: list
      parent: /RegulatoryCompliance
    post:
      description: Create a new Supporting Document.
      tags:
      - NumbersV2SupportingDocument
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.supporting_document'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateSupportingDocument
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              title: CreateSupportingDocumentRequest
              properties:
                FriendlyName:
                  type: string
                  description: The string that you assigned to describe the resource.
                Type:
                  type: string
                  description: The type of the Supporting Document.
                Attributes:
                  description: The set of parameters that are the attributes of the
                    Supporting Documents resource which are derived Supporting Document
                    Types.
              required:
              - FriendlyName
              - Type
    get:
      description: Retrieve a list of all Supporting Document for an account.
      tags:
      - NumbersV2SupportingDocument
      parameters:
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListSupportingDocumentResponse
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.regulatory_compliance.supporting_document'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListSupportingDocument
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/SupportingDocuments/{Sid}:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - friendly_name
      pathType: instance
      parent: /RegulatoryCompliance
    get:
      description: Fetch specific Supporting Document Instance.
      tags:
      - NumbersV2SupportingDocument
      parameters:
      - name: Sid
        in: path
        description: The unique string created by Twilio to identify the Supporting
          Document resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^RD[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.supporting_document'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchSupportingDocument
      x-maturity:
      - GA
    post:
      description: Update an existing Supporting Document.
      tags:
      - NumbersV2SupportingDocument
      parameters:
      - name: Sid
        in: path
        description: The unique string created by Twilio to identify the Supporting
          Document resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^RD[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.supporting_document'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateSupportingDocument
      x-maturity:
      - GA
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              title: UpdateSupportingDocumentRequest
              properties:
                FriendlyName:
                  type: string
                  description: The string that you assigned to describe the resource.
                Attributes:
                  description: The set of parameters that are the attributes of the
                    Supporting Document resource which are derived Supporting Document
                    Types.
      x-twilio:
        addContentTypeIfEmptyForm: true
    delete:
      description: Delete a specific Supporting Document.
      tags:
      - NumbersV2SupportingDocument
      parameters:
      - name: Sid
        in: path
        description: The unique string created by Twilio to identify the Supporting
          Document resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^RD[0-9a-fA-F]{32}$
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteSupportingDocument
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/SupportingDocumentTypes:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - friendly_name
      pathType: list
      parent: /RegulatoryCompliance
    get:
      description: Retrieve a list of all Supporting Document Types.
      tags:
      - NumbersV2SupportingDocumentType
      parameters:
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is
          50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                title: ListSupportingDocumentTypeResponse
                properties:
                  supporting_document_types:
                    type: array
                    items:
                      $ref: '#/components/schemas/numbers.v2.regulatory_compliance.supporting_document_type'
                  meta:
                    type: object
                    properties:
                      first_page_url:
                        type: string
                        format: uri
                      next_page_url:
                        type: string
                        format: uri
                        nullable: true
                      page:
                        type: integer
                      page_size:
                        type: integer
                      previous_page_url:
                        type: string
                        format: uri
                        nullable: true
                      url:
                        type: string
                        format: uri
                      key:
                        type: string
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListSupportingDocumentType
      x-maturity:
      - GA
  /v2/RegulatoryCompliance/SupportingDocumentTypes/{Sid}:
    servers:
    - url: https://numbers.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties:
      - sid
      - friendly_name
      pathType: instance
      parent: /RegulatoryCompliance
    get:
      description: Fetch a specific Supporting Document Type Instance.
      tags:
      - NumbersV2SupportingDocumentType
      parameters:
      - name: Sid
        in: path
        description: The unique string that identifies the Supporting Document Type
          resource.
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/numbers.v2.regulatory_compliance.supporting_document_type'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchSupportingDocumentType
      x-maturity:
      - GA
servers:
- url: https://numbers.twilio.com
tags:
- name: NumbersV2AuthorizationDocument
- name: NumbersV2BulkHostedNumberOrder
- name: NumbersV2Bundle
- name: NumbersV2BundleCopy
- name: NumbersV2DependentHostedNumberOrder
- name: NumbersV2EndUser
- name: NumbersV2EndUserType
- name: NumbersV2Evaluation
- name: NumbersV2HostedNumberOrder
- name: NumbersV2ItemAssignment
- name: NumbersV2Regulation
- name: NumbersV2ReplaceItems
- name: NumbersV2SupportingDocument
- name: NumbersV2SupportingDocumentType
x-maturity:
- name: GA
  description: This product is Generally Available.
- name: Beta
  description: PLEASE NOTE that this is a Beta product that is subject to change.
    Use it with caution.