Skip to main content
The Feedal REST API lets you manage forms, read responses, and control integrations programmatically. All requests use HTTPS and return JSON.

​
Base URL

https://api.feedal.com/api/
All endpoint paths in this documentation are relative to this base URL.

​
Authentication

Authenticated endpoints require a Bearer token in the Authorization header. Obtain a token by creating an API key in the dashboard (Developers → API Keys). 
Authorization: Bearer sk_live_your_api_key_here
Public respondent endpoints (starting /v2/r/) do not require authentication — they are open for embedding in your front-end.

​
Request format

Send JSON bodies with Content-Type: application/json: 
POST /api/v2/form/ HTTP/1.1
Host: api.feedal.com
Authorization: Bearer sk_live_your_api_key_here
Content-Type: application/json

{
  "title": "Customer feedback"
}

​
Response format

Successful responses return JSON. List endpoints use a paginated envelope: 
{
  "count": 100,
  "next": "https://api.feedal.com/api/v2/form/?limit=20&offset=20",
  "previous": null,
  "results": [ ... ]
}
Single-resource endpoints return the object directly (no envelope).

​
Pagination

All list endpoints support cursor-based pagination via query parameters:
ParameterDefaultDescription
limit20Results per page (max 100)
offset0Number of results to skip

​
Filtering and sorting

ParameterDescription
orderingField to sort by — prefix with - for descending (e.g. -created)
searchFull-text search on supported fields
Endpoint-specific filters are documented on each endpoint page.

​
Error responses

All errors return a JSON body with a detail field: 
{
  "detail": "Authentication credentials were not provided."
}
Validation errors may include an errors array: 
{
  "detail": "Validation error.",
  "errors": ["title: This field is required."]
}

​
HTTP status codes

CodeMeaning
200OK
201Created
204No content (successful delete)
400Bad request — validation error or missing field
401Unauthorized — missing or invalid API key
403Forbidden — you don’t own this resource
404Not found
409Conflict — e.g. slug collision
500Server error

​
API key management

See API keys for how to create, rotate, and revoke keys.

​
Next steps

Forms

List, create, update, and publish forms.

Sessions & responses

Read respondent sessions and their answers.