---
title: "Returns all accounts."
method: GET
path: "/account/v1/accounts"
tags: ["Account"]
---

# Returns all accounts.

`GET /account/v1/accounts`

## Request

- Base URL: `https://api.apaleo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.apaleo.com/account/v1/accounts`
- Auth: OAuth 2
  - Implicit: `https://identity.apaleo.com/connect/authorize`
  - Scopes: `accounts.read`

Get the list of accounts.<br>You must have this scope: 'accounts.read'.

## Query parameters

- `accountCodes` string[]

## Response `200`

Return all accounts.

- AccountListModel
  - `accounts` AccountItemModel[], required: List of accounts
    - `code` string, required: The code for the account that can be shown in reports and table views
    - `name` string, required: The name for the account, which usually should be the company name
    - `description` string, nullable: The description for the account
    - `type` 'Trial' | 'Live' | 'Suspended' | 'Development', required: Type of the account
  - `count` integer, required: Total count of items

## Other responses

- `204`: There are no accounts found.
- `400`: Bad request.
- `401`: You are unauthorized.
- `403`: Forbidden.
- `404`: The Request-URI could not be found.
- `422`: Validation errors in the request body or query params.
- `499`: Client closed request.
- `500`: An unexpected error occurred.
- `503`: The server is currently unavailable. Please try later.

---

[API](https://skmtc.dev/apaleo/apis/apaleo-account-api.md) - [All operations](https://skmtc.dev/apaleo/apis/apaleo-account-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apaleo/apis/apaleo-account-api/revisions/8fbc9ab84376?raw)