API Reference

The Fillvox API is a REST + JSON service. All requests require authentication via a workspace API key, which you can generate under Settings → API in the dashboard.

Authentication

Pass your API key as a Bearer token in the Authorization header:

curl https://api.fillvox.example/v1/forms 
  -H "Authorization: Bearer fk_live_..."

List forms

Returns the most recent 50 form submissions in reverse chronological order. Use the cursor query param to paginate.

GET /v1/forms?cursor=eyJkYXRl...

200 OK
{
  "data": [
    { "id": "frm_01H...", "template": "jsa_v3", "submitted_at": "2026-04-30T10:14:00Z", ... }
  ],
  "next_cursor": "eyJkYXRl..."
}

Webhooks

Configure webhooks under Settings → Webhooks. We deliver events with at-least-once semantics and exponential backoff retries up to 24 hours.

Rate limits

Default limit is 600 requests per minute per workspace. Enterprise customers can request higher limits.