API Reference

List Polls

GET /polls — list emails that have in-email poll responses.

GET/polls

Returns one summary row per email that has collected poll responses, most recent first. Use the email_id to fetch the full answer breakdown with Retrieve Poll Results.

Requires an API key with read access.

const res = await fetch('https://api.mailblastr.com/polls', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);

Response

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "poll",
      "email_id": "8f2e4a3b-dfbc-4e9a-8b2c-5f3a1d6e7c8d",
      "subject": "How was your experience?",
      "responses": 128,
      "distinct_answers": 3,
      "last_response_at": "2026-07-04T10:12:00.000Z"
    }
  ]
}