Sign in

v1

latestOpenAPI 3.0.32026-07-26120117318.1 KB
Screens

List screens

Returns a paginated list of screens for the authenticated project. Screens are ordered by creation date (newest first) and include every screen visible in the Qonversion dashboard (statuses draft, published, modified, and historical legacy). Supports cursor-based pagination via limit and starting_after.

get/screens

Query parameters

limitinteger

Maximum number of screens to return. Min 1, max 100.

starting_afterstring

Cursor for pagination. Pass the id of the last screen from the previous page to fetch the next page.

If the cursor does not match a known screen id (for example the screen was deleted between calls), pagination restarts from the top of the list and the response carries an X-Qon-Pagination-Restarted: true header so clients can detect the restart and decide whether to deduplicate.

Response

A paginated list of screens.

object'list' required
urlstring required
has_moreboolean required

Whether more pages are available.

next_cursorstring nullable

Present only when has_more is true. Pass as starting_after for the next page.

Example response

{
  "url": "/v4/screens",
  "data": [
    {
      "id": "scr_abc123",
      "url": "/v4/screens/scr_abc123",
      "name": "Onboarding Paywall",
      "status": "published",
      "created_at": "2025-09-15T12:30:00Z",
      "updated_at": "2025-11-03T10:26:40Z"
    }
  ]
}