Skip to content
POLLAIRS

Developers

POLLAIRS API

Everything in the console is available over the REST API. Create an API key in your console, then drive campaigns and pull results programmatically.

Authentication

Send your secret key as a bearer token. Keys are prefixed pk_live_ and shown once when created.

curl https://<your-domain>/api/v1/calls \
  -H "Authorization: Bearer pk_live_xxx"

Create calls

Queue outbound survey calls for one project. Each contact gets a call driven by the project's survey.

POST/api/v1/calls
{
  "project": "household-2026",
  "contacts": [
    { "name": "Amara", "phone": "+447700900123" }
  ]
}

// 202 Accepted
{
  "queued": 1,
  "calls": [{ "id": "...", "status": "queued" }]
}

List calls

GET/api/v1/calls?project=household-2026
{
  "calls": [
    {
      "id": "...",
      "status": "completed",
      "durationSec": 108,
      "responses": { "q1": "4", "q2": "yes" },
      "recordingUrl": "https://..."
    }
  ]
}

Webhooks

POLLAIRS posts call lifecycle events to your endpoint. Call events are received at:

POST/api/webhooks/calls

Events: call.started, call.completed, call.failed.