Skip to main content
GET
/
api
/
v1
/
forms
/
{id}
/
submissions
curl -X GET "https://api.usegately.com/api/v1/forms/form_abc123/submissions?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "id": "sub_001",
      "form_id": "form_abc123",
      "data": {
        "full_name": "John Doe",
        "email": "john@example.com",
        "message": "I have a question about your product..."
      },
      "member_id": null,
      "metadata": {
        "ip": "192.168.1.1",
        "user_agent": "Mozilla/5.0...",
        "referrer": "https://example.com/contact"
      },
      "created_at": "2024-01-20T15:30:00Z"
    },
    {
      "id": "sub_002",
      "form_id": "form_abc123",
      "data": {
        "full_name": "Jane Smith",
        "email": "jane@example.com",
        "message": "Great product! I'd like to learn more..."
      },
      "member_id": "mem_xyz789",
      "metadata": {
        "ip": "192.168.1.2",
        "user_agent": "Mozilla/5.0...",
        "referrer": "https://example.com/pricing"
      },
      "created_at": "2024-01-20T14:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 245,
    "total_pages": 13
  }
}

​
Path Parameters

​
id
string
required
The form’s unique identifier

​
Query Parameters

​
page
number
default:"1"
Page number for pagination
​
limit
number
default:"20"
Number of submissions per page (max 100)
​
start_date
string
Filter submissions from this date (ISO 8601)
​
end_date
string
Filter submissions until this date (ISO 8601)
​
search
string
Search within submission data

​
Response

​
success
boolean
Whether the request was successful
​
data
array
Array of submission objects
​
pagination
object
Pagination metadata
curl -X GET "https://api.usegately.com/api/v1/forms/form_abc123/submissions?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "id": "sub_001",
      "form_id": "form_abc123",
      "data": {
        "full_name": "John Doe",
        "email": "john@example.com",
        "message": "I have a question about your product..."
      },
      "member_id": null,
      "metadata": {
        "ip": "192.168.1.1",
        "user_agent": "Mozilla/5.0...",
        "referrer": "https://example.com/contact"
      },
      "created_at": "2024-01-20T15:30:00Z"
    },
    {
      "id": "sub_002",
      "form_id": "form_abc123",
      "data": {
        "full_name": "Jane Smith",
        "email": "jane@example.com",
        "message": "Great product! I'd like to learn more..."
      },
      "member_id": "mem_xyz789",
      "metadata": {
        "ip": "192.168.1.2",
        "user_agent": "Mozilla/5.0...",
        "referrer": "https://example.com/pricing"
      },
      "created_at": "2024-01-20T14:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 245,
    "total_pages": 13
  }
}

​
Export Submissions

You can also export submissions in CSV format: 
curl -X GET "https://api.usegately.com/api/v1/forms/form_abc123/submissions/export?format=csv" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o submissions.csv

​
Notes

  • Submissions are returned in reverse chronological order by default
  • The data object contains field IDs as keys and submitted values
  • File uploads are returned as URLs to the stored files
  • Sensitive data (like passwords) is never returned in submissions