---
title: "Retrieve a list of HostedNumberOrders belonging to the account initiating the request."
method: GET
path: "/v2/HostedNumber/Orders"
tags: ["NumbersV2HostedNumberOrder"]
---

# Retrieve a list of HostedNumberOrders belonging to the account initiating the request.

`GET /v2/HostedNumber/Orders`

Retrieve a list of HostedNumberOrders belonging to the account initiating the request.

## Query parameters

- `Status` 'twilio-processing' | 'received' | 'pending-verification' | 'verified' | 'pending-loa' | 'carrier-processing' | 'testing' | 'completed' | 'failed' | 'action-required' — 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.
- `SmsCapability` boolean
- `PhoneNumber` string, phone-number
- `IncomingPhoneNumberSid` string
- `FriendlyName` string
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `items` NumbersV2HostedNumberOrder[]
    - `sid` string, nullable — A 34 character string that uniquely identifies this HostedNumberOrder.
    - `account_sid` string, nullable — A 34 character string that uniquely identifies the account.
    - `incoming_phone_number_sid` string, nullable — 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` string, nullable — A 34 character string that uniquely identifies the Address resource that represents the address of the owner of this phone number.
    - `signing_document_sid` string, nullable — 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` string, phone-number, nullable — Phone number to be hosted. This must be in [E.164](https://en.wikipedia.org/wiki/E.164) format, e.g., +16175551212
    - `capabilities` object, nullable — Set of booleans describing the capabilities hosted on Twilio's platform. SMS is currently only supported.
      - `mms` boolean
      - `sms` boolean
      - `voice` boolean
      - `fax` boolean
    - `friendly_name` string, nullable — A 128 character string that is a human-readable text that describes this resource.
    - `status` 'twilio-processing' | 'received' | 'pending-verification' | 'verified' | 'pending-loa' | 'carrier-processing' | 'testing' | 'completed' | 'failed' | 'action-required' — 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` string, nullable — A message that explains why a hosted_number_order went to status "action-required"
    - `date_created` string, date-time, nullable — The date this resource was created, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format.
    - `date_updated` string, date-time, nullable — The date that this resource was updated, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format.
    - `email` string, nullable — Email of the owner of this phone number that is being hosted.
    - `cc_emails` string[], nullable — A list of emails that LOA document for this HostedNumberOrder will be carbon copied to.
    - `url` string, uri, nullable — The URL of this HostedNumberOrder.
    - `contact_title` string, nullable — The title of the person authorized to sign the Authorization Document for this phone number.
    - `contact_phone_number` string, phone-number, nullable — The contact phone number of the person authorized to sign the Authorization Document.
    - `bulk_hosting_request_sid` string, nullable — A 34 character string that uniquely identifies the bulk hosting request associated with this HostedNumberOrder.
    - `next_step` string, nullable — The next step you need to take to complete the hosted number order and request it successfully.
    - `verification_attempts` integer — The number of attempts made to verify ownership via a call for the hosted phone number.
    - `verification_call_sids` string[], nullable — The Call SIDs that identify the calls placed to verify ownership.
    - `verification_call_delay` integer — The number of seconds to wait before initiating the ownership verification call. Can be a value between 0 and 60, inclusive.
    - `verification_call_extension` string, nullable — The numerical extension to dial when making the ownership verification call.
    - `verification_code` string, nullable — The digits the user must pass in the ownership verification call.
    - `verification_type` 'phone-call' — The method used to verify ownership of the number to be hosted. Can be: `phone-call` or `phone-bill` and the default is `phone-call`.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

---

[API](https://skmtc.net/twilio/apis/twilio-numbers.md) · [All operations](https://skmtc.net/twilio/apis/twilio-numbers/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-numbers/revisions/4e238625c212/schema)