fastsubmit.
Get Started

Submissions API

Retrieve and manage form submissions via the REST API.

Base URL: https://fastsubmit.hostspica.com/api/v1

List Submissions

GET/forms/:formId/submissions

Returns all submissions for a specific form.

Query Parameters

limit(number, default: 100)

Max submissions to return (max 1000)

format(string, default: json)

Response format: json or csv

Example Request

curl -X GET \
  "https://fastsubmit.hostspica.com/api/v1/forms/abc123/submissions?limit=50" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "success": true,
  "formId": "abc123",
  "formName": "Contact Form",
  "count": 2,
  "submissions": [
    {
      "id": "sub_001",
      "name": "John Doe",
      "email": "john@example.com",
      "_meta": {
        "submittedAt": "2024-01-15T14:30:00.000Z"
      }
    }
  ]
}

Export as CSV

GET/forms/:formId/submissions?format=csv

Export all submissions as a CSV file for use in spreadsheets.

Example Request

curl -X GET \
  "https://fastsubmit.hostspica.com/api/v1/forms/abc123/submissions?format=csv" \
  -H "x-api-key: YOUR_API_KEY" \
  -o submissions.csv

Response

name,email,message,submittedAt
John Doe,john@example.com,Hello!,2024-01-15T14:30:00.000Z

Get Single Submission

GET/forms/:formId/submissions/:submissionId

Retrieve a specific submission by its ID.

Example Request

curl -X GET \
  https://fastsubmit.hostspica.com/api/v1/forms/abc123/submissions/sub_001 \
  -H "x-api-key: YOUR_API_KEY"

Delete Submission

DELETE/forms/:formId/submissions/:submissionId

Delete a specific submission.

Example Request

curl -X DELETE \
  https://fastsubmit.hostspica.com/api/v1/forms/abc123/submissions/sub_001 \
  -H "x-api-key: YOUR_API_KEY"

Delete All Submissions

DELETE/forms/:formId/submissions

Delete all submissions for a form.

Warning: This will permanently delete all submissions. This action cannot be undone.

Example Request

curl -X DELETE \
  https://fastsubmit.hostspica.com/api/v1/forms/abc123/submissions \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "success": true,
  "message": "Submissions deleted",
  "deleted": 42
}