Skip to main content
GET
https://api.usegately.com
/
api
/
v1
/
forms
curl -X GET "https://api.usegately.com/api/v1/forms?status=published" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "id": "form_abc123",
      "name": "Contact Form",
      "description": "Main contact form",
      "type": "contact",
      "status": "published",
      "submission_count": 245,
      "created_at": "2024-01-10T10:00:00Z",
      "updated_at": "2024-01-18T14:30:00Z"
    },
    {
      "id": "form_xyz789",
      "name": "Signup Form",
      "description": "Member registration",
      "type": "signup",
      "status": "published",
      "submission_count": 1024,
      "created_at": "2024-01-05T09:00:00Z",
      "updated_at": "2024-01-15T11:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 5,
    "total_pages": 1
  }
}

​
Query Parameters

​
page
number
default:"1"
Page number for pagination
​
limit
number
default:"20"
Number of forms per page (max 100)
​
status
string
Filter by status: published, draft, archived
​
type
string
Filter by form type: signup, contact, feedback, custom

​
Response

​
success
boolean
Whether the request was successful
​
data
array
Array of form objects
curl -X GET "https://api.usegately.com/api/v1/forms?status=published" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "id": "form_abc123",
      "name": "Contact Form",
      "description": "Main contact form",
      "type": "contact",
      "status": "published",
      "submission_count": 245,
      "created_at": "2024-01-10T10:00:00Z",
      "updated_at": "2024-01-18T14:30:00Z"
    },
    {
      "id": "form_xyz789",
      "name": "Signup Form",
      "description": "Member registration",
      "type": "signup",
      "status": "published",
      "submission_count": 1024,
      "created_at": "2024-01-05T09:00:00Z",
      "updated_at": "2024-01-15T11:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 5,
    "total_pages": 1
  }
}