Formspark Documentation

Appearance

Pagination ​

List endpoints return a page and a cursor:

json
{
  "data": [
    { "id": "sub_1", "formId": "your-form-id", "data": {}, "createdAt": "..." }
  ],
  "hasMore": true,
  "nextCursor": "MjAyNi0wNy0yOVQwOTo..."
}

Branch on hasMore. While it is true, pass nextCursor back as startingAfter:

sh
curl "https://api.formspark.io/public/v1/forms/your-form-id/submissions?limit=50&startingAfter=$CURSOR" \
  -H "Authorization: Bearer $FORMSPARK_TOKEN"

limit accepts 1 to 100 and defaults to 25.

Cursors are opaque ​

A cursor is a string to hand back untouched. Do not build one, decode one, or derive one from a submission's id or createdAt: what a cursor encodes is an implementation detail and it will change. A cursor this API did not issue, or one that has been modified, comes back as a 400 validation_error.

Walking every submission ​

sh
CURSOR=""
while : ; do
  RESPONSE=$(curl -s \
    "https://api.formspark.io/public/v1/forms/your-form-id/submissions?limit=100${CURSOR:+&startingAfter=$CURSOR}" \
    -H "Authorization: Bearer $FORMSPARK_TOKEN")
  echo "$RESPONSE" | jq -c '.data[]'
  [ "$(echo "$RESPONSE" | jq -r '.hasMore')" = "true" ] || break
  CURSOR=$(echo "$RESPONSE" | jq -r '.nextCursor')
done

Workspaces and forms use the same envelope, so branching on hasMore works everywhere.