Authentication
This endpoint requires an API key for authentication. You can provide it in two ways:
- Recommended:
X-API-Key header
- Alternative:
apiKey query parameter
Path Parameters
The unique identifier of the form
Query Parameters
Number of submissions to return per page. Minimum: 1, Maximum: 100
Cursor for pagination. Use the nextCursor value from the previous response to fetch the next page
Filter submissions created on or after this date (ISO 8601 format). Only available for STANDARD and PRO plans
Filter submissions created before this date (ISO 8601 format). The full day is included. Only available for STANDARD and PRO plans
API key for authentication (alternative to X-API-Key header)
Response
Array of submission objectsUnique identifier for the submission
ISO 8601 timestamp of when the submission was created
Email address associated with the submission, if provided
The form submission dataMetadata about the submission. Available for STANDARD and PRO plans only.Browser information (e.g., “Chrome”, “Safari”)
Country code (e.g., “US”, “GB”)
Timestamp of the submission
Cursor to use for fetching the next page. If undefined, there are no more results
The user’s current plan: FREE, STANDARD, or PRO
Rate Limiting
This endpoint is rate limited. When rate limits are enabled, the following headers are included in the response:
X-RateLimit-Limit: Maximum number of requests allowedX-RateLimit-Remaining: Number of requests remainingX-RateLimit-Reset: Unix timestamp when the rate limit resets
If you exceed the rate limit, you’ll receive a 429 status code.
Plan-Based Features
Date Filtering
- FREE plan: Date filtering is not available. Requesting
startDate or endDate returns a 403 error
- STANDARD & PRO plans: Can filter submissions using
startDate and endDate parameters
- FREE plan: The
_meta field is completely removed from submission data
- STANDARD & PRO plans: Receive sanitized metadata including browser, country, and timestamp
curl -X GET "https://api.mantlz.com/api/v1/forms/form_123/submissions?limit=20" \
-H "X-API-Key: your_api_key_here"
Response Example
{
"submissions": [
{
"id": "submission_123",
"createdAt": "2024-01-15T10:30:00.000Z",
"email": "[email protected]",
"data": {
"name": "John Doe",
"message": "This is a test submission",
"_meta": {
"browser": "Chrome",
"country": "US",
"timestamp": "2024-01-15T10:30:00.000Z"
}
}
}
],
"nextCursor": "submission_124",
"plan": "PRO"
}
Error Responses
Invalid parameters (e.g., limit out of range, invalid API key format)
Invalid or inactive API key
- Date filtering attempted on FREE plan
- Form not found or access denied
Too many requests. Check rate limit headers for reset time
Server error occurred while processing the request
The API key’s lastUsedAt timestamp is automatically updated when this endpoint is called successfully.