Skip to main content
GET
/
forms
List forms
curl --request GET \
  --url https://app.oneform.one/api/v1/forms \
  --header 'Authorization: Bearer <token>'
{
  "forms": [
    {
      "id": "XXXX",
      "name": "My Form",
      "created_at": "2024-01-01T12:00:00Z",
      "updated_at": "2024-01-02T12:00:00Z",
      "status": "published"
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 100,
  "has_next": true
}

Authorizations

Authorization
string
header
required

Enter your API key

Query Parameters

page
integer

Page number (default: 1)

limit
integer
default:50

Items per page (default: 50)

Required range: 1 <= x <= 500
filter
enum<string>

Filter forms by status (published, draft, all)

Available options:
published,
draft,
all

Response

successful

forms
object[]

Array of form objects

page
integer

Current page number

Example:

1

limit
integer

Number of items per page

Example:

50

total
integer

Total number of forms

Example:

100

has_next
boolean

Whether there are more pages available

Example:

true