---
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`

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

---

[API](https://skmtc.dev/twilio/apis/preview.md) · [All operations](https://skmtc.dev/twilio/apis/preview/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/preview/revisions/eec1185131a7/schema)