---
title: "List Accounts"
method: GET
path: "/Accounts"
tags: ["Accounts"]
---

# List Accounts

`GET /Accounts`

This endpoint will return a list that contains Project you are connecting as and any subprojects.

#### Permissions
The API token must include the following scopes: _Management_.

## Query parameters

- `FriendlyName` string
- `Page` integer
- `PageSize` integer
- `PageToken` string

## Response `200`

The request has succeeded.

- AccountListResponse — Response containing a list of accounts.
  - `uri` string, required — The URI of the current page.
  - `first_page_uri` string, required — The URI of the first page.
  - `next_page_uri` string, nullable, required — The URI of the next page. Null if there are no more results.
  - `previous_page_uri` string, nullable, required — The URI of the previous page. Null if this is the first page.
  - `page` integer, required — The current page number (zero-indexed).
  - `page_size` integer, required — The number of results per page.
  - `accounts` Account[], required — List of accounts.
    - `sid` string, uuid, required — The unique identifier for this Project.
    - `friendly_name` string, required — The name of the Project.
    - `status` 'active' | 'suspended' | 'closed', required — The status of the Project.
    - `auth_token` string, required — The authorization token for this Project. Always returns 'redacted' for security.
    - `date_created` string, required — The date and time this Project was created, in RFC 2822 format.
    - `date_updated` string, required — The date and time this Project was last updated, in RFC 2822 format.
    - `type` 'Trial' | 'Full', required — The type of the Project.
    - `owner_account_sid` string, uuid, required — The Project ID of the parent project. For parent projects, this is the same as sid.
    - `region_preference` string, required — The preferred region for the Project.
    - `uri` string, required — The URI for the Project.
    - `subproject` boolean, required — Whether this project is a sub-project of another project.
    - `signing_key` string, nullable, required — The signing key for the Project. Currently not supported and always null.
    - `subresource_uris` SubresourceUris, required — A Map of sub-resources that are linked to the given Project.
      - `addresses` string, nullable, required — URI for addresses. Currently not supported and always null.
      - `available_phone_numbers` string, required — URI for available phone numbers.
      - `applications` string, required — URI for applications.
      - `authorized_connect_apps` string, nullable, required — URI for authorized connect apps. Currently not supported and always null.
      - `calls` string, required — URI for calls.
      - `conferences` string, required — URI for conferences.
      - `connect_apps` string, nullable, required — URI for connect apps. Currently not supported and always null.
      - `incoming_phone_numbers` string, required — URI for incoming phone numbers.
      - `keys` string, nullable, required — URI for keys. Currently not supported and always null.
      - `notifications` string, nullable, required — URI for notifications. Currently not supported and always null.
      - `outgoing_caller_ids` string, nullable, required — URI for outgoing caller IDs. Currently not supported and always null.
      - `queues` string, required — URI for queues.
      - `recordings` string, required — URI for recordings.
      - `sandbox` string, nullable, required — URI for sandbox. Currently not supported and always null.
      - `sip` string, nullable, required — URI for SIP. Currently not supported and always null.
      - `short_codes` string, nullable, required — URI for short codes. Currently not supported and always null.
      - `messages` string, required — URI for messages.
      - `transcriptions` string, required — URI for transcriptions.
      - `usage` string, nullable, required — URI for usage. Currently not supported and always null.

## Other responses

- `401` — Authentication failed. Please verify your credentials and try again.

## Changes

- **2026-01-19** `d5fbaaddfa3e` — 2 warning, 10 info
  - removed the optional property `applications` from the response with the `200` status
  - removed the optional property `links` from the response with the `200` status
  - added the new optional `query` request parameter `Page`
  - added the new optional `query` request parameter `PageSize`
  - …8 more
- **2026-01-15** `1e7bbde00d70` — 2 breaking, 2 info
  - the `applications/items/status` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `applications/items/type` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - added `#/components/schemas/AccountStatus` to the `applications/items/status` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AccountType` to the `applications/items/type` response property `allOf` list for the response status `200`
- **2026-01-15** `686ef84c2abc` — 1 breaking
  - the response property `links/allOf[#/components/schemas/Pagination]/previous_page_uri` became nullable for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/get.md)

---

[API](https://skmtc.dev/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.dev/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/revisions/d5fbaaddfa3e/schema)
