Form Insights
Get submission analytics for a specific form — totals, trends, and time-series data.
forms.view
GET
/v1/forms/:id/insightsQuery Parameters
rangestringTime range: 7d, 30d, 90d, all (default: 7d)
Example Request
curl
curl "https://proforms.io/api/v1/forms/f_abc123/insights?range=30d" \
-H "Authorization: Bearer pf_your_api_key"Response
200 OK
{
"success": true,
"data": {
"summary": {
"totalSubmissions": 87,
"submissionsToday": 3,
"conversionRate": null,
"avgCompletionTime": null
},
"chartData": [
{
"date": "2026-01-18",
"submissions": 3
},
{
"date": "2026-01-19",
"submissions": 5
},
{
"date": "2026-01-20",
"submissions": 2
}
],
"deviceBreakdown": [
{
"name": "Desktop",
"value": 68.5,
"count": 60
},
{
"name": "Mobile",
"value": 28.7,
"count": 25
},
{
"name": "Tablet",
"value": 2.3,
"count": 2
}
],
"topFields": [
{
"field": "Email",
"completionRate": 100
},
{
"field": "Name",
"completionRate": 98.5
},
{
"field": "Message",
"completionRate": 72.3
}
],
"hourlyDistribution": [
{
"hour": 0,
"submissions": 1
},
{
"hour": 9,
"submissions": 12
}
],
"dayOfWeek": [
{
"day": "Mon",
"submissions": 15
},
{
"day": "Tue",
"submissions": 18
}
],
"recentSubmissions": [
{
"name": "John Smith",
"email": "john@example.com",
"time": "2 hours ago"
}
]
}
}