P
ProFormsDocs

Form Insights

Get submission analytics for a specific form — totals, trends, and time-series data.

forms.view
GET/v1/forms/:id/insights

Query Parameters

rangestring

Time 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"
      }
    ]
  }
}