Quick Start

QNAAPI is the backend for polls, quizzes, and forms/surveys. Create an account, get an API key, and start creating resources in minutes.

Base URL

All API endpoints are served from:

https://qnaapi.com/api/v1

1. Create an account & get an API key

• Go to /register and create an account through the normal web sign-up form — there is no separate JSON registration endpoint.
• Log in and open API health & keys in the dashboard — a Default key is created for you automatically, shown there in the form qna_....
• Create additional named keys from that same page — one per website/integration is a good default, so you can tell which site is calling and revoke just that one if it's ever compromised. See API Keys.

2. Create your first poll

Every management request (creating, reading, updating, deleting your own resources) requires your key as an X-API-Key header.

curl -X POST https://qnaapi.com/api/v1/polls \
  -H "X-API-Key: qna_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "What is your favorite color?",
    "options": ["Red", "Blue"]
  }'

{
  "data": {
    "id": 2,
    "identifier": "what-is-your-favorite-color",
    "title": "What is your favorite color?",
    "description": null,
    "metadata": null,
    "site_id": null,
    "options": [
      { "id": 3, "label": "Red", "votes_count": 0 },
      { "id": 4, "label": "Blue", "votes_count": 0 }
    ],
    "created_at": "2026-08-14T22:44:43.000000Z",
    "updated_at": "2026-08-14T22:44:43.000000Z"
  }
}

identifier behaves like a post slug — leave it out and it's generated from the title automatically. Full details in Polls.

3. Let your end-users respond — no key needed

Casting a vote, submitting a quiz attempt, and submitting a form are all public endpoints — call them directly from your end-users' own browser or app, no backend proxy required.

curl -X POST https://qnaapi.com/api/v1/polls/2/votes \
  -H "Content-Type: application/json" \
  -d '{ "poll_option_id": 3, "voter_identifier": "end-user-42" }'