---
title: "List sub-accounts"
method: GET
path: "/v1/sub-organizations"
tags: ["Sub-accounts"]
---

# List sub-accounts

`GET /v1/sub-organizations`

Returns a paginated list of sub-accounts under the authenticated master account.

## Query parameters

- `status` 'enabled' | 'disabled'

## Response `200`

Returns a paginated list of sub-accounts.

- SubAccountsListResponse
  - `sub_organizations` SubOrganizationResponse[] — Subaccounts belonging to the authenticated account.
    - `id` integer, required — Sub-account ID.
    - `created_at` string, date-time, required — Date and time the sub-account was created in ISO 8601 format.
    - `name` string, required — Sub-account name.
    - `api_key` string, required — Sub-account API key.
    - `master_organization` integer, required — Master account ID.
    - `status` 'enabled' | 'disabled', required — Status of the subaccount. One of `enabled` (the subaccount is active and can be used) or `disabled` (the subaccount is suspended).
    - `default_destinations` object, required — Default webhook URLs for inbound messages and delivery reports.
      - `sms_endpoint` string, uri, required — Inbound messages webhook URL.
      - `dlr_endpoint` string, uri, required — Delivery report webhook URL.
  - `pagination` Pagination
    - `current_page` integer, required — Current page number.
    - `per_page` integer, required — Number of records per page.
    - `total` integer, required — Total number of records.
    - `total_pages` integer, required — Total number of pages.

## Other responses

- `401` — Unauthorized
- `403` — Request failed. The feature is disabled for your account.

---

[API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/versions/b22f170488b6/schema)