# List what sends from a domain

`GET /v1/sending-domains/{id}/usage`

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

Campaigns not yet sent (draft, scheduled or sending) and journeys with an email step whose sender is on this domain, up to 50 of each, most recently edited first. Transactional sends name their sender per request, so they are not listed.

## 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)
  - `items` (object[], required)
    - `id` (string, required, uuid)
    - `name` (string, required)
    - `status` (string, required)
  - `hasMore` (boolean, required)
- `journeys` (object, required)
  - `items` (object[], required)
    - `id` (string, required, uuid)
    - `name` (string, required)
    - `status` (string, required)
  - `hasMore` (boolean, required)

## Example

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

Response `200`:

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