List poptins

get

https://api.popt.in/v1/poptins

Browse your popups and forms with per-Poptin aggregate metrics so you can rank performers or find a Poptin to inspect.

A/B versions are nested under their parents. Responses also include last_updated_at and refresh_status for the account’s stats cache. Paginated (per_page default 10, max 100).

Query Params

stat_from

date

required

Start of the stats aggregation period (UTC calendar date). Aggregates events on or after this day.

stat_to

date

required

End of the stats aggregation period (UTC calendar date). Aggregates events on or before this day.

device

string | null

enum

Device filter for metric totals. Omit for all devices.

Allowed:

type

string | null

enum

Filter by poptin product type (popup or form). Omit for both.

Allowed:

domain

string | null

Exact domain filter within the authenticated account.

include

string | null

Optional extras (comma-separated): conversion_breakdown, timeseries.

status

string | null

Filter by one or more poptin statuses (comma-separated): active, inactive, draft.

created_from

date | null

Include poptins created on or after this date (UTC). Filters which poptins appear; does not change stats aggregation.

created_to

date | null

Include poptins created on or before this date (UTC). Filters which poptins appear; does not change stats aggregation.

page

integer | null

≥ 1

Page number for offset pagination.

per_page

integer | null

1 to 100

Number of top-level poptins per page (max 100). Default: 10.

Responses

200PoptinListResponse

401Unauthenticated.

403ForbiddenError

422Validation failed.

429TooManyRequestsError