List Forms

Returns all forms belonging to the authenticated account.


GET /v1/forms

Request


curl https://api.formtorch.com/v1/forms \
  -H "Authorization: Bearer YOUR_API_KEY"

Query parameters

Parameter	Type	Description
`projectId`	string	Filter forms by project ID
`limit`	integer	Number of results per page (default: 20, max: 100)
`cursor`	string	Pagination cursor from previous response

Response


{
  "forms": [
    {
      "id": "a1b2c3d4e5",
      "name": "Contact Form",
      "projectId": "p9q8r7s6t5",
      "submissionCount": 142,
      "createdAt": "2025-01-10T09:00:00.000Z",
      "updatedAt": "2025-03-01T14:22:00.000Z"
    },
    {
      "id": "f6g7h8i9j0",
      "name": "Newsletter Signup",
      "projectId": "p9q8r7s6t5",
      "submissionCount": 891,
      "createdAt": "2025-01-15T11:30:00.000Z",
      "updatedAt": "2025-02-20T08:10:00.000Z"
    }
  ],
  "nextCursor": "eyJpZCI6ImY2ZzdoOGk5ajAifQ"
}

Response fields

Field	Type	Description
`forms`	array	List of form objects
`forms[].id`	string	Form ID (10 characters)
`forms[].name`	string	Form display name
`forms[].projectId`	string	Parent project ID
`forms[].submissionCount`	integer	Total non-spam submissions received
`forms[].createdAt`	string	ISO 8601 creation timestamp
`forms[].updatedAt`	string	ISO 8601 last updated timestamp
`nextCursor`	string or null	Pass to `cursor` param for the next page