Skip to main content
GET
/
forms
Retrieve a list of forms
curl --request GET \
  --url https://app.formbox.app/api/v1/forms \
  --header 'api-key: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "type": "endpoint",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "imageCompressionType": [
        "webp"
      ],
      "isClosed": true,
      "submissions": 123,
      "organizationId": "<string>"
    }
  ],
  "meta": {
    "total": 123
  },
  "pagination": {
    "totalPages": 123,
    "currentPage": 123,
    "nextPage": 123,
    "previousPage": 123
  }
}

Headers

api-key
string
required

The API key.

Query Parameters

Search for a form by name.

type
enum<string>

Filter forms by type.

Available options:
endpoint,
hosted
sort
enum<string>
default:createdAt

The field to sort the forms by. The default is createdAt, and sort order is always descending.

Available options:
createdAt,
submissions
page
integer
default:1

The page number for pagination.

Example:

1

pageSize
integer
default:20

The number of items per page.

Required range: x <= 100
Example:

50

Response

A list of forms.

data
Form · object[]
required

The list of items.

meta
object
required

Extra metadata about the response.

pagination
object
required

Pagination metadata.

Last modified on January 7, 2026