List Forms

Returns a paginated list of your forms.

GET /forms

Query Parameters

Parameter	Type	Required	Default	Description
`status`	string	No	`all`	Filter: `published`, `draft`, or `all`
`limit`	number	No	`10`	Items per page (1–100)
`offset`	number	No	`0`	Number of items to skip

Response

{
  "data": [
    {
      "id": "abc123",
      "name": "Contact Form",
      "status": "published",
      "fieldCount": 5,
      "submissionCount": 142,
      "url": "https://makeform.ai/f/abc123",
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-03-01T14:22:00Z"
    }
  ],
  "total": 12,
  "page": 1,
  "limit": 10,
  "has_more": true
}

Code Examples

curl https://api.makeform.ai/forms \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxx"

# Filter published forms only
curl "https://api.makeform.ai/forms?status=published&limit=20" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxx"