← Back to Blog

API: Read Form Submissions and Questionnaire Responses

You can now read the answers people give on your website through the PresenceWave API. Form and survey submissions, and questionnaire responses, can go straight into your CRM, a spreadsheet or your own scripts, so you don't need to export them from the dashboard.

New in the API

  • List your widgets: GET /external/v1/widgets. You can filter by type, for example ?type=FORM.
  • Read widget submissions: GET /external/v1/widgets/{widgetId}/submissions. Each submission includes the time it was sent and the page it was sent from. The answers are labelled with your field names and come in the same order as on your form.
  • List your questionnaires: GET /external/v1/questionnaires. Each one includes its public URL.
  • Read questionnaire responses: GET /external/v1/questionnaires/{id}/responses. By default this returns every response with at least one answer, including people who stopped partway. Add completed=true to get only finished responses.

All four endpoints are read-only and paged. Both submission and response endpoints take a since timestamp, so a script that runs every hour can fetch only what is new since its last run. The API reference has the details and examples. It also has a new design to match the rest of presencewave.com.

Other improvements

  • Job board sitemap: every job board now has a sitemap.xml that lists its open jobs, so search engines find new postings sooner.
  • Atom feed for blogs: alongside the existing RSS feed, every blog now has an Atom feed at atom.xml, and feed readers find it automatically.
  • Docs and API links in the dashboard: the top bar now links straight to the documentation and the API reference.
  • Survey widget fix: icons in the survey widget now show on every website, including sites with a strict content security policy that loads no icon fonts of its own.
  • Better on phones: many public pages and widgets have tidier layouts on small screens.