---
title: "Retrieve a list of dependent HostedNumberOrders belonging to the AuthorizationDocument."
method: GET
path: "/HostedNumbers/AuthorizationDocuments/{SigningDocumentSid}/DependentHostedNumberOrders"
tags: ["PreviewHostedNumbersDependentHostedNumberOrder"]
---

# Retrieve a list of dependent HostedNumberOrders belonging to the AuthorizationDocument.

`GET /HostedNumbers/AuthorizationDocuments/{SigningDocumentSid}/DependentHostedNumberOrders`

## Request

- Base URL: `https://preview.twilio.com`
- URL: `https://preview.twilio.com/HostedNumbers/AuthorizationDocuments/{SigningDocumentSid}/DependentHostedNumberOrders`
- Auth: HTTP basic

Retrieve a list of dependent HostedNumberOrders belonging to the AuthorizationDocument.

## Path parameters

- `SigningDocumentSid` string, required

## Query parameters

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

## Response `200`

OK

- object
  - `items` PreviewHostedNumbersAuthorizationDocumentDependentHostedNumberOrder[]
    - `sid` string, nullable: A 34 character string that uniquely identifies this Authorization Document
    - `account_sid` string, nullable: The unique SID identifier of the Account.
    - `incoming_phone_number_sid` string, nullable: A 34 character string that uniquely identifies the IncomingPhoneNumber resource created by this HostedNumberOrder.
    - `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 LOA document associated with this HostedNumberOrder.
    - `phone_number` string, phone-number, nullable: An E164 formatted phone number hosted by this HostedNumberOrder.
    - `capabilities` object, nullable: A mapping of capabilities this hosted phone number will have enabled on Twilio's platform.
      - `mms` boolean
      - `sms` boolean
      - `voice` boolean
      - `fax` boolean
    - `friendly_name` string, nullable: A human readable description of this resource, up to 64 characters.
    - `unique_name` string, nullable: Provides a unique and addressable name to be assigned to this HostedNumberOrder, assigned by the developer, to be optionally used in addition to SID.
    - `status` 'twilio-processing' | 'received' | 'pending-verification' | 'verified' | 'pending-loa' | 'carrier-processing' | 'testing' | 'completed' | 'failed' | 'action-required': 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` 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.
    - `verification_attempts` integer: The number of attempts made to verify ownership of the phone number that is being hosted.
    - `email` string, nullable: Email of the owner of this phone number that is being hosted.
    - `cc_emails` string[], nullable: Email recipients who will be informed when an Authorization Document has been sent and signed
    - `verification_type` 'phone-call' | 'phone-bill': The method used for verifying ownership of the number to be hosted. One of phone-call (default) or phone-bill.
    - `verification_document_sid` string, nullable: A 34 character string that uniquely identifies the Identity Document resource that represents the document for verifying ownership of the number to be hosted.
    - `extension` string, nullable: A numerical extension to be used when making the ownership verification call.
    - `call_delay` integer: A value between 0-30 specifying the number of seconds to delay initiating the ownership verification call.
    - `verification_code` string, nullable: The digits passed during the ownership verification call.
    - `verification_call_sids` string[], nullable: A list of 34 character strings that are unique identifiers for the calls placed as part of ownership verification.
  - `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

## Changes

> 69 revisions in range; 49 not diffed.

- **2023-01-13** `42de5948249e`: 2 breaking
  - the response property `meta/next_page_url` became nullable for the status `200`
  - the response property `meta/previous_page_url` became nullable for the status `200`
- **2022-08-04** `f637b0d2427b`: 2 breaking, 1 info
  - for the `query` request parameter `PhoneNumber`, the format changed from no format to `phone-number`
  - the `items/items/capabilities` response's property format changed from no format to `phone-number-capabilities` for status `200`
  - api operation id `ListDependentHostedNumberOrder` removed and replaced with `ListHostedNumbersDependentHostedNumberOrder`

[Operation history](https://skmtc.dev/twilio/apis/twilio-preview/changes/HostedNumbers/AuthorizationDocuments/:SigningDocumentSid/DependentHostedNumberOrders/get.md)

---

[API](https://skmtc.dev/twilio/apis/twilio-preview.md) - [All operations](https://skmtc.dev/twilio/apis/twilio-preview/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/twilio-preview/revisions/1d44f6bde1ff?raw)