# List what uses a segment

`GET /v1/segments/{id}/usage`

Requires an API key with the `segments:read` scope. [About keys and scopes](/docs/api/authentication)

Campaigns whose audience is this segment or whose rules name it, journeys whose rules or steps name it, and other segments whose rules name it. While any is listed, deleting the segment is refused (409 `IN_USE`, with this usage in `details`).

## Path parameters

- `id` (string, required, uuid)

## Returns

Returns `200 OK`. Otherwise returns an error; [Errors](/docs/api/errors) lists every code and which to retry.

- `campaigns` (object[], required)
  - `id` (string, required, uuid)
  - `name` (string, required)
- `journeys` (object[], required)
  - `id` (string, required, uuid)
  - `name` (string, required)
- `segments` (object[], required)
  - `id` (string, required, uuid)
  - `name` (string, required)

## Example

```bash
curl https://api.kirora.io/v1/segments/018f2a4e-6b1c-7d3e-9f40-37386ae05a6b/usage \
  -H "Authorization: Bearer $KIRORA_API_KEY"
```

Response `200`:

```json
{
  "data": {
    "campaigns": [
      {
        "id": "018f2a4e-6b1c-7d3e-9f40-37386ae05a6b",
        "name": "Weekend specials"
      }
    ],
    "journeys": [
      {
        "id": "018f2a4e-6b1c-7d3e-9f40-37386ae05a6b",
        "name": "Weekend specials"
      }
    ],
    "segments": [
      {
        "id": "018f2a4e-6b1c-7d3e-9f40-37386ae05a6b",
        "name": "Weekend specials"
      }
    ]
  }
}
```