Skip to main content
GET
List lead lists

Overview

Retrieves all lead lists with optional filtering by active status. This endpoint allows you to get a paginated list of all lead lists in your account.

Query Parameters

Response

The response includes a paginated list of lead lists with the following structure:
  • count: Total number of lead lists
  • next: URL for next page (null if no more pages)
  • previous: URL for previous page (null if first page)
  • results: Array of lead list objects

Lead List Object

Each lead list object contains:
  • id: Internal lead list ID
  • lead_id: Unique lead list identifier
  • name: Name of the lead list
  • created: Creation timestamp
  • modified: Last modification timestamp
  • is_active: Whether the lead list is active
  • usage_count: Number of times this lead list has been used
  • entries_count: Number of lead entries in this list
  • linked_qrs: Array of QR codes linked to this lead list

Examples

Get All Lead Lists

Get Only Active Lead Lists

Get Only Inactive Lead Lists

Use Cases

  • Dashboard Overview: Display all lead lists in your account
  • Active Management: Filter to show only active lead lists
  • Analytics: Get usage statistics for lead lists
  • QR Code Integration: See which QR codes are linked to each lead list
Lead lists are used to capture user information when QR codes are scanned. Each lead list can be attached to multiple QR codes, but each QR code can only have one lead list attached.

Authorizations

Authorization
string
header
required

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.

Response

200

List of lead lists