REST Endpoints Overview

REST Endpoints Overview & API Reference

The Voieform REST API enables full programmatic management of your form endpoints, submission archives, webhook configurations, and analytics. All requests should be made over HTTPS.

Production Base URL

https://api.voieform.com/v1

Available REST Endpoints

Method	Endpoint Path	Auth Required	Description
POST	/f/{form_key}	Public (Form Key)	Submit new form payload.
GET	/v1/forms	Bearer Token	List all active forms in user account.
POST	/v1/forms	Bearer Token	Create a new form endpoint programmatically.
GET	/v1/forms/{form_id}/submissions	Bearer Token	List form submission entries (supports pagination & status filter).
DELETE	/v1/submissions/{id}	Bearer Token	Delete a submission entry permanently.
POST	/v1/webhooks	Bearer Token	Register new webhook listener URL.

Example: Fetching Submissions via REST API

cURL Request

get-submissions.shbash

# Fetch submissions programmatically via REST API
curl -X GET "https://api.voieform.com/v1/forms/frm_live_x92a/submissions?page=1&limit=20&status=verified" \
  -H "Authorization: Bearer vf_sec_99a88b77c66d55" \
  -H "Accept: application/json"

JSON Response

response.jsonjson

{
  "success": true,
  "page": 1,
  "limit": 20,
  "total_count": 142,
  "submissions": [
    {
      "id": "sub_98a72b1c4e",
      "form_id": "frm_live_x92a",
      "status": "verified",
      "spam_score": 0.02,
      "created_at": "2026-08-15T18:30:00Z",
      "fields": {
        "name": "Sarah Connor",
        "email": "sarah@cyberdyne.org",
        "message": "Interested in enterprise pricing."
      },
      "files": []
    }
  ]
}

Rate Limits

Management REST API requests are rate limited to **120 requests per minute** per Secret API Key. Exceeding this limit returns an HTTP 429 status code.

Need help?

Contact Support