> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracklysms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Child Accounts

> List every child account under your parent.

Returns all children of the calling parent account. Requires a **parent** key with `accounts.read` (or `accounts.write`).

## Response Fields

<ResponseField name="children" type="array">
  Array of child objects — each with `accountId`, `name`, `status`, `plan`, `externalIds`, `billedByParent`, and `createdAt` (see [Create Child](/api-reference/v2/accounts/create-child#response-fields)).
</ResponseField>

## Examples

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.tracklysms.com/api/v2/accounts/children \
    -H "X-Api-Key: trk_your_parent_key"
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://api.tracklysms.com/api/v2/accounts/children",
      headers={"X-Api-Key": "trk_your_parent_key"},
  )
  for child in resp.json()["children"]:
      print(child["accountId"], child["name"], child["status"])
  ```
</RequestExample>

<ResponseExample>
  ```json Success (200) theme={null}
  {
    "children": [
      {
        "accountId": 1042,
        "name": "Acme West",
        "status": "active",
        "plan": "paid",
        "externalIds": { "partnerId": "p_1", "businessId": "b_9", "locationId": "loc_west" },
        "billedByParent": true,
        "createdAt": "2026-07-26T14:03:11.123456"
      }
    ]
  }
  ```
</ResponseExample>

## Error Codes

| HTTP Status | Error Code             | Description                                 |
| ----------- | ---------------------- | ------------------------------------------- |
| 403         | `not_a_parent_account` | The calling key belongs to a child account. |
| 403         | `insufficient_scope`   | The key lacks the `accounts.read` scope.    |

Also `401 invalid_credentials`, `403 account_suspended`.