---
title: "Account"
description: "<p>Account related resources of the *Lytics API*.</p><p>The Account resource describes an account. An account can be a *Master* account, which</p><p>means that it is a billing account. Master accounts have children accounts</p><p>which act more as separate projects, for same billing account. Each child</p><p>account can be used for Dev, Testing, etc., or for separate siloes of data</p><p>for sub-divisions, etc..</p><p>The Account resource has the following attributes:</p><p>| field       | DataType         | Description   |</p><p>|-------------|------------------|---------------|</p><p>| id          | string           | unique id</p><p>| created     | Date             | Created date</p><p>| updated     | Date             | Last Updated Date</p><p>| domain      | string           | customer-assigned unique id (auto assigned to domain name).  This must be unique across lytics accounts</p><p>| email       | string           | primary email contact for account owner</p><p>| parent_id   | string           | parent account if this account is a child-account of master billing account</p><p>| name        | string           | account name</p>"
url: "https://www.contentstack.com/docs/developers/apis/lytics-api/v1/account"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-11-05"
---

# Account

Account related resources of the \*Lytics API\*.

The Account resource describes an account. An account can be a \*Master\* account, which

means that it is a billing account. Master accounts have children accounts

which act more as separate projects, for same billing account. Each child

account can be used for Dev, Testing, etc., or for separate siloes of data

for sub-divisions, etc..

The Account resource has the following attributes:

| field | DataType | Description |

|-------------|------------------|---------------|

| id | string | unique id

| created | Date | Created date

| updated | Date | Last Updated Date

| domain | string | customer-assigned unique id (auto assigned to domain name). This must be unique across lytics accounts

| email | string | primary email contact for account owner

| parent\_id | string | parent account if this account is a child-account of master billing account

| name | string | account name

## Retrieve a Single Account

### Retrieve a Single Account

**GET** `/api/account/{id}`

Get single account by id.

#### URL Parameters

- **id** (required)
  id of account.

#### Query Parameters

- **account_id** (optional)
  Your Lytics account ID.

#### Headers

- **Authorization** (optional)

#### Sample Response

```json
{
  "created": "2014-10-30T21:01:06.493Z",
  "updated": "2014-10-30T21:01:06.493Z",
  "domain": "example.lytics.io",
  "email": "notreal@lytics.io",
  "id": "CNakHAobwEeLuUyrKc5AQTif",
  "name": "Lytics Test",
  "parent_id": "CNakHAobwEeLuUyrKc5AQTif",
  "timezone": "America/Los_Angeles"
}
```

## Account Update

### Account Update

**PUT** `/api/account/{id}`

Post update to account. See list of fields above.

#### URL Parameters

- **id** (required)
  id of account.

#### Query Parameters

- **account_id** (optional)
  Your Lytics account ID.

#### Headers

- **Authorization** (optional)

#### Sample Response

```json
{
  "created": "2014-10-30T21:01:06.493Z",
  "updated": "2014-10-30T21:01:06.493Z",
  "domain": "example.lytics.io",
  "email": "notreal@lytics.io",
  "id": "CNakHAobwEeLuUyrKc5AQTif",
  "name": "Lytics Test",
  "parent_id": "CNakHAobwEeLuUyrKc5AQTif",
  "timezone": "America/Los_Angeles"
}
```

## Accounts List

### Accounts List

**GET** `/api/account`

#### Headers

- **Authorization** (optional)

#### Sample Response

```json
{
  "status": "success",
  "data": [
    {
      "apikey": "ceHNqmr0ELpNTjRhVg7FFpzM",
      "created": "2014-10-30T21:01:06.493Z",
      "dataapikey": "qQsOcWCe-QipNGC2n5NRVVH7",
      "domain": "example.lytics.io",
      "email": "notreal@lytics.io",
      "id": "CNakHAobwEeLuUyrKc5AQTif",
      "name": "Lytics Test",
      "parent_id": "CNakHAobwEeLuUyrKc5AQTif",
      "features": {
        "segment-sizes": true
      }
    }
  ]
}
```

## Account Create

### Account Create

**POST** `/api/account`

To create a child Account of a parent account, just post:

#### Query Parameters

- **account_id** (optional)
  Your Lytics account ID.

#### Headers

- **Authorization** (optional)

#### Sample Response

```json
{
  "created": "2014-10-30T21:01:06.493Z",
  "updated": "2014-10-30T21:01:06.493Z",
  "domain": "example.lytics.io",
  "email": "notreal@lytics.io",
  "id": "CNakHAobwEeLuUyrKc5AQTif",
  "name": "Lytics Test",
  "parent_id": "CNakHAobwEeLuUyrKc5AQTif",
  "timezone": "America/Los_Angeles"
}
```