GET
/
forms
Retrieve a list of forms
curl --request GET \
  --url https://api.tally.so/forms \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "<string>",
      "name": "<string>",
      "workspaceId": "<string>",
      "status": "BLANK",
      "numberOfSubmissions": 123,
      "isClosed": true,
      "payments": [
        {
          "amount": 123,
          "currency": "<string>"
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "page": 123,
  "limit": 123,
  "total": 123,
  "hasMore": true
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
number

Page number for pagination (default: 1)

limit
number

Number of forms per page (default: 50, max: 500)

Required range: 1 <= x <= 500
workspaceIds
string[]

Filter forms by specific workspace IDs (encoded strings)

Response

200 - application/json

A paginated list of forms

items
object[]
required
page
number
required

Current page number

limit
number
required

Number of items per page

total
number
required

Total number of items

hasMore
boolean
required

Whether there are more pages available