---
title: "Retrieve a list of AuthorizationDocuments belonging to the account initiating the request."
method: GET
path: "/HostedNumbers/AuthorizationDocuments"
tags: ["PreviewHostedNumbersAuthorizationDocument"]
---

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

`GET /HostedNumbers/AuthorizationDocuments`

## Request

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

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

## Query parameters

- `Email` string
- `Status` 'opened' | 'signing' | 'signed' | 'canceled' | 'failed': 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.
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `items` PreviewHostedNumbersAuthorizationDocument[]
    - `sid` string, nullable: A 34 character string that uniquely identifies this AuthorizationDocument.
    - `address_sid` string, nullable: A 34 character string that uniquely identifies the Address resource that is associated with this AuthorizationDocument.
    - `status` 'opened' | 'signing' | 'signed' | 'canceled' | 'failed': 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` string, nullable: Email that this AuthorizationDocument will be sent to for signing.
    - `cc_emails` string[], nullable: Email recipients who will be informed when an Authorization Document has been sent and signed.
    - `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.
    - `url` string, uri, nullable
    - `links` object, nullable
  - `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/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)