# List, Get & Delete


Once you have created audiences and activations, you manage them with the
standard list / get / delete reads.

## Audiences

### List

`GET /api/v2/analyses/audiences/index`

Returns your company's audiences, paginated, in the standard
[envelope](/concepts/envelope). Accepts `page`, `per_page` and `search`
(case-insensitive contains on the audience name).

```bash
curl "https://console.intuizi.com/api/v2/analyses/audiences/index" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

### Get one

`GET /api/v2/analyses/audiences/{id}`

Returns a single audience by id, including its lifecycle status. See
[Read an Audience](/guides/read-an-audience) for the response shape and how to
interpret status.

```bash
curl "https://console.intuizi.com/api/v2/analyses/audiences/88" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

### Delete

`POST /api/v2/analyses/audiences/delete-by-id`

```bash
curl -X POST "https://console.intuizi.com/api/v2/analyses/audiences/delete-by-id" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "id": 88 }'
```

## Activations

### List

`GET /api/v2/analyses/activations/index`

Returns your company's activations, paginated, in the standard envelope.
Accepts `page`, `per_page` and `search` (case-insensitive contains on the
activation name). Credentials and other secrets are never present.

```bash
curl "https://console.intuizi.com/api/v2/analyses/activations/index" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

### Get one

`GET /api/v2/analyses/activations/{id}`

Returns a single activation by id, including its lifecycle status and datastream
results. See [Read an Activation](/guides/read-an-activation) for the response
shape.

```bash
curl "https://console.intuizi.com/api/v2/analyses/activations/91" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"
```

### Delete

`POST /api/v2/analyses/activations/delete-by-id`

```bash
curl -X POST "https://console.intuizi.com/api/v2/analyses/activations/delete-by-id" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "id": 91 }'
```

{{< callout type="warning" >}}
`delete-by-id` is destructive. Deleting an audience also removes its linked data
and cannot be undone.
{{< /callout >}}

## Reference

- Read responses: [Read an Audience](/guides/read-an-audience),
  [Read an Activation](/guides/read-an-activation)
- Envelope: [Request & Response Envelope](/concepts/envelope)
- Field-level contract: [API Reference - Audiences]({{< relref "/api/v2/audiences" >}}),
  [Activations]({{< relref "/api/v2/activations" >}})