List Forms

Returns all forms belonging to the authenticated account, ordered by most recently created first.


GET /v1/forms

Request


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

Query parameters

Parameter	Type	Default	Description
`limit`	integer	25	Results per page (max: 100 Starter, 250 Pro)
`cursor`	string	none	Pagination cursor from previous response
`order`	string	`desc`	Sort direction: `desc` (newest first) or `asc` (oldest first)

Response


{
  "data": [
    {
      "id": "a1b2c3d4e5",
      "name": "Contact Form",
      "status": "active",
      "projectId": "p9q8r7s6t5",
      "createdAt": "2025-01-10T09:00:00.000Z",
      "updatedAt": "2025-03-01T14:22:00.000Z"
    },
    {
      "id": "f6g7h8i9j0",
      "name": "Newsletter Signup",
      "status": "active",
      "projectId": "p9q8r7s6t5",
      "createdAt": "2025-01-15T11:30:00.000Z",
      "updatedAt": "2025-02-20T08:10:00.000Z"
    }
  ],
  "next_cursor": "eyJjcmVhdGVkQXQiOiIyMDI1LTAxLTE1VDExOjMwOjAwLjAwMFoiLCJpZCI6ImY2ZzdoOGk5ajAifQ",
  "has_more": false
}

Response fields

Field	Type	Description
`data`	array	List of form objects
`data[].id`	string	Form ID (10 characters)
`data[].name`	string	Form display name
`data[].status`	string	Form status (`active`, `disabled`)
`data[].projectId`	string	Parent project ID
`data[].createdAt`	string	ISO 8601 creation timestamp
`data[].updatedAt`	string	ISO 8601 last updated timestamp
`next_cursor`	string or null	Pass as `cursor` to fetch the next page
`has_more`	boolean	Whether more results exist beyond this page