---
title: "List sub-accounts"
method: GET
path: "/v1/sub_accounts"
tags: ["subAccounts"]
---

# List sub-accounts

`GET /v1/sub_accounts`

Lists sub-accounts owned by the caller, newest first. q performs a case-insensitive substring search on name only; percent and underscore characters are treated literally.

## Query parameters

- `q` string
- `enabled` 'true' | 'false'
- `page` integer
- `per_page` integer
- `sort_by` 'created_at'
- `sort_order` 'asc' | 'desc'

## Headers

- `Authorization` string, required

## Response `200`

sub-accounts list

- TypeSubAccountsListSubAccountsResponse
  - `data` TypeSubAccount[]
    - `object` 'sub_account', required
    - `id` string, uuid, required
    - `name` string, required
    - `external_id` string, nullable, required — Idempotency key supplied by the parent account, unique within that parent
    - `enabled` boolean, required
    - `products` string[], required
    - `created_at` string, date-time, required
  - `object` string, required
  - `has_more` boolean, required
  - `total_count` integer

## Other responses

- `400` — invalid enabled filter
- `403` — sub-account provisioning not enabled
- `422` — invalid pagination

## Changes

- **2026-09-03** `ac0d9be94846` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/middesk/apis/middesk-api/changes/v1/sub_accounts/get.md)

---

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