---
title: "Retrieve a sub-account"
method: GET
path: "/v1/sub-organizations/{id}"
tags: ["Sub-accounts"]
---

# Retrieve a sub-account

`GET /v1/sub-organizations/{id}`

Returns the sub-account identified by `id`.

## Path parameters

- `id` integer, required

## Response `200`

Returns the sub-account.

- SubOrganizationResponse — Sub-account details including API key and webhook configurations.
  - `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.

## Other responses

- `401` — Unauthorized
- `403` — Request failed. The feature is disabled for your account.
- `404` — Request failed. An object with the specified ID is not found.

---

[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)