Available on: Gold, Platinum plans
Before you can use the form APIs, you first need to create your form's API keys, create an authenticated request, and retrieve your form's hashid.
Get Submissions
GET https://formspree.io/api/0/forms/<hashid>/submissions
Fetch all your submissions.
Example:
curl -u :API_KEY https://formspree.io/api/0/forms/<hashid>/submissions
Sample result:
{
"fields": [
"_id",
"_date",
"_replyto",
"message"
],
"submissions": [
{
"_date": "2018-11-03T07:28:29.707632",
"_id": 2,
"_replyto": "myemail@example.com",
"message": "asdfasdf"
},
...
]
}
Filtering results
You can filter results by passing URL parameters to the Get Submissions endpoint.
since
Use the since
parameter to get all submissions since a date. Dates must be ISO formatted, such as 2018-11-03T12:00:00
.
Example:
curl https://formspree.io/api/0/forms/<hashid>/submissions?since=2018-11-03T12:00:00
limit
Use the limit
parameter to limit the number of results.
Example:
curl https://formspree.io/api/0/forms/<hashid>/submissions?limit=10
order
Use the order
parameter to change the order. By default the order is desc
.
Example:
curl https://formspree.io/api/0/forms/<hashid>/submissions?order=asc