EasePop
  • Home
  • Features
  • Documentation
  • FAQ
  • Showcase
  • Pricing
  • Contact
Log inGet Started
EasePop Knowledge Base
EasePop Knowledge Base
EasePop Documentation
User Submissions
Plan Usage Limits
API Reference
API Authentication
Get submissions GET
Update submission status PATCH
Delete submission DELETE
API Reference/Submission

Get submissions

Retrieve a paginated list of submissions with optional filtering

GET
/api/submission

Authorization

x-api-key<token>

API key for authentication

In: header

Query Parameters

limit?integer

Number of items to return (1-100)

Default10
Range1 <= value <= 100
offset?integer

Number of items to skip

Default0
Range0 <= value
popupId?string

Filter by popup ID

Length1 <= length <= 256
domain?string

Filter by domain

Length1 <= length <= 512
device?string

Filter by device type

Length1 <= length <= 128
status?string

Filter by submission status

Value in"pending" | "completed"
orderBy?string

Sort order for results

Default"created_at_desc"
Value in"created_at" | "created_at_desc"

Response Body

curl -X GET "https://api.easepop.dev/api/submission?limit=10&offset=0&popupId=string&domain=string&device=string&status=pending&orderBy=created_at"

{
  "items": [
    {
      "submissionId": "123e4567-e89b-12d3-a456-426614174000",
      "popupId": "popup_123",
      "data": {
        "email": "user@example.com",
        "name": "John Doe"
      },
      "domain": "example.com",
      "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
      "device": "desktop",
      "status": "pending",
      "createdAt": "2025-07-12T10:30:00Z"
    }
  ],
  "limit": 10,
  "offset": 0,
  "total": 1
}
{
  "message": "string"
}

{
  "message": "API key is required"
}

{
  "message": "string"
}

API Authentication

Learn how to authenticate with our API.

Update submission status PATCH

Next Page