---
title: "Get a list of Decodable Accounts of which the authenticated user is a member."
method: GET
path: "/accounts"
tags: ["Account Operations"]
---

# Get a list of Decodable Accounts of which the authenticated user is a member.

`GET /accounts`

## Request

- Base URL: `https://replace-with-account.api.decodable.co/v1alpha2`
- URL: `https://replace-with-account.api.decodable.co/v1alpha2/accounts`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://auth.decodable.co/authorize?audience=https://api.decodable.co/`
    - Token URL: `https://auth.decodable.co/oauth/token`
- TypeScript: <https://skmtc.dev/decodable/apis/decodable-control-plane/docs/accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

Any authenticated user (or app client) has permission to list Accounts of which they are a Member.

## Query parameters

- `page_size` integer
- `page_token` string
- `view` 'basic' | 'full': The amount of data to return for the resource(s). A value of `basic` returns the standard properties of the resource. It may also produce data that is considered "computationally cheap" to return. Specifying `basic` is the same as omitting this parameter. The behavior of `full` is service-dependent, but generally includes more fields. This can mean additional status or version data, or even expanding references to contained resources. This should be used when the cost of an additional API roundtrip is greater than the overhead of the request.

## Response `200`

A list of Decodable Accounts.

- object
  - `next_page_token` string: A token that, that when passed to a subsequent call as page_token, will return the next page of results.
  - `items` AccountCommon[], required: An array of accounts.
    - `name` string, required: The Decodable Account name, globally unique, hostname segment compliant.
    - `display_name` string, required: Unconstrained, for display.
    - `auth0_org_id` string, required: The organization id from Auth0 for this account

## Other responses

- `400`: An invalid request was received.
- `default`: An error has occurred.

---

[API](https://skmtc.dev/decodable/apis/decodable-control-plane.md) - [All operations](https://skmtc.dev/decodable/apis/decodable-control-plane/llms.txt) - [OpenAPI document](https://skmtc.dev/decodable/apis/decodable-control-plane/revisions/9718a3019da8?raw)