Fetch leads

Every form submission in a Riddle is stored as a lead. Besides sending leads to integrations or exporting them in the Creator, you can also fetch them directly via the API – e.g. to sync them into your own CRM or database.

Note: The leads endpoint is available for the Business and Enterprise plans.

Fetching the leads of a Riddle

To fetch the leads of a Riddle, use the /leads/riddle/{UUID} API endpoint. By default the newest 25 leads are returned; use the page and limit parameters to paginate through the leads.

You can use the following optional parameters:

Property	Type	Description	Default
`page`	integer	The page you want to return	first page
`limit`	integer	How many results the page should contain (maximum: 200)	25
`search`	string	Search term; exact match for an email address, or partial match for data in the current page
`completed`	boolean	Set to `true` to only return completed leads; if not sent, all leads are returned
`orderBy`	string	By which field to order; available: `createdAt`
`order`	string	The order of the results; `ASC` or `DESC`
`dateFrom`	string	Only return leads from this date on (format: `Y-m-d`)
`dateTo`	string	Only return leads up to this date (format: `Y-m-d`)

Example: Fetch the 50 newest completed leads of June 2026:

{
    "page": 1,
    "limit": 50,
    "completed": true,
    "orderBy": "createdAt",
    "order": "DESC",
    "dateFrom": "2026-06-01",
    "dateTo": "2026-06-30"
}

Next steps

Send leads to integrations: Learn how leads work and how to send them to Google Sheets, Mailchimp, webhooks, and more.
Analyze your Riddles: Use the Stats API to analyze views, starts, and submissions.

Manage RiddlesTags - Manage Riddles

ApiAPI Docs