---
title: "A business's email campaigns, sending addresses and emailable audience (emails:read)."
method: GET
path: "/v1/email-campaigns"
---

# A business's email campaigns, sending addresses and emailable audience (emails:read).

`GET /v1/email-campaigns`

## Request

- Base URL: `https://www.kaicalls.com/api`
- URL: `https://www.kaicalls.com/api/v1/email-campaigns`
- Auth: HTTP bearer

Without sender_id: the campaign view, the same one the dashboard campaign page shows: senders with their setup readiness, recent campaigns (or the one named by campaign_id) with status, the revision fingerprint the owner approves, outcome counts, and the audience that can be emailed (recorded consent, not on the do-not-email list). With sender_id: the DNS records that sending domain needs. Any member of the business can read. 503 email_campaigns_unavailable when the review cannot be built right now.

## Query parameters

- `business_id` string, required
- `campaign_id` string
- `sender_id` string

## Response `200`

Campaign view, or the sender setup records

## Other responses

- `400`: business_id is required (invalid_request)
- `403`: Missing emails:read scope or no access to business_id
- `503`: email_campaigns_unavailable

---

[API](https://skmtc.dev/kaicalls/apis/kaicalls-public-api.md) · [All operations](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/revisions/e607fc6cf36e?raw)