List lead lists
curl --request GET \
--url https://management.scanova.io/lead/ \
--header 'Authorization: <api-key>'import requests
url = "https://management.scanova.io/lead/"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://management.scanova.io/lead/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://management.scanova.io/lead/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://management.scanova.io/lead/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://management.scanova.io/lead/")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://management.scanova.io/lead/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_bodyLead List Management
List Lead Lists
Retrieves all lead lists with optional filtering. Requires authentication.
GET
/
lead
/
List lead lists
curl --request GET \
--url https://management.scanova.io/lead/ \
--header 'Authorization: <api-key>'import requests
url = "https://management.scanova.io/lead/"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://management.scanova.io/lead/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://management.scanova.io/lead/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://management.scanova.io/lead/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://management.scanova.io/lead/")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://management.scanova.io/lead/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_bodyOverview
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
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
is_active | boolean | No | Filter lead lists by active status | true or false |
Response
The response includes a paginated list of lead lists with the following structure:count: Total number of lead listsnext: 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 IDlead_id: Unique lead list identifiername: Name of the lead listcreated: Creation timestampmodified: Last modification timestampis_active: Whether the lead list is activeusage_count: Number of times this lead list has been usedentries_count: Number of lead entries in this listlinked_qrs: Array of QR codes linked to this lead list
Examples
Get All Lead Lists
curl -X GET "https://management.scanova.io/lead/" \
-H "Authorization: YOUR_API_KEY"
Get Only Active Lead Lists
curl -X GET "https://management.scanova.io/lead/?is_active=true" \
-H "Authorization: YOUR_API_KEY"
Get Only Inactive Lead Lists
curl -X GET "https://management.scanova.io/lead/?is_active=false" \
-H "Authorization: YOUR_API_KEY"
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
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
Was this page helpful?
⌘I