Read responses

Every response is in the dashboard under Responses, where you can search, filter and export CSV. Each one is also emailed to the workspace owner.

From the terminal

In a folder where you ran formto init:

console

npx -y https://formto.io/dl/cli-latest.tgz responses
npx -y https://formto.io/dl/cli-latest.tgz responses --json

From the API

Responses come newest first, a page at a time. Pass nextCursor back as cursor for the next page.

FORM_ID=$(curl -fsS https://api.formto.io/v2/forms -H "Authorization: Bearer $FORMTO_TOKEN" \
  | node -p 'const d = JSON.parse(require("fs").readFileSync(0, "utf8")).data; d.length ? d[0].id : ""')
if [ -n "$FORM_ID" ]; then
  curl -fsS "https://api.formto.io/v2/submissions?formId=$FORM_ID&limit=10" -H "Authorization: Bearer $FORMTO_TOKEN"
fi

A token needs the submissions:read scope to read responses. Deleting needs submissions:delete, which is never granted unless you tick it.

Held responses

When a workspace passes its monthly allowance, new responses are still stored but marked held: they are kept and shown, and are delivered once you upgrade. See pricing for each plan's allowance.