LISTS
Get all Lists
API to fetch a paginated list of all lists created in your workspace.
GET
/
v1
/
subscriber_list
/
Get all Lists
curl --request GET \
--url https://hub.suprsend.com/v1/subscriber_list/ \
--header 'Authorization: Bearer <token>'import requests
url = "https://hub.suprsend.com/v1/subscriber_list/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://hub.suprsend.com/v1/subscriber_list/', 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://hub.suprsend.com/v1/subscriber_list/",
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: Bearer <token>"
],
]);
$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://hub.suprsend.com/v1/subscriber_list/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://hub.suprsend.com/v1/subscriber_list/")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://hub.suprsend.com/v1/subscriber_list/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"meta": {
"count": 53,
"limit": 2,
"offset": 0
},
"results": [
{
"drafts": null,
"source": null,
"status": "active",
"list_id": "list_01",
"list_name": "sample list 01",
"list_type": "static_list",
"created_at": "2025-04-04T07:33:06.943+00:00",
"updated_at": "2025-04-04T07:33:06.943+00:00",
"version_id": null,
"is_readonly": false,
"track_user_exit": false,
"list_description": "_some sample description_",
"track_user_entry": false,
"subscribers_count": 0,
"requested_for_delete": false
},
{
"drafts": null,
"source": "database_sync",
"status": "active",
"list_id": "list_02",
"list_name": "sample list 02",
"list_type": "static_list",
"created_at": "2024-12-20T12:09:28.727+00:00",
"updated_at": "2025-04-04T07:32:32.127275+00:00",
"version_id": null,
"is_readonly": false,
"track_user_exit": true,
"list_description": "_some sample description_",
"track_user_entry": true,
"subscribers_count": 31,
"requested_for_delete": false
}
]
}"Not Authenticated - could not find Workspace details"Authorizations
Pass as Bearer <API_KEY>. Get API Key from SuprSend dashboard Developers -> API Keys section.
Query Parameters
number of results to be returned in API response
starting position of tenant list
Was this page helpful?
Previous
Get List ConfigurationAPI to fetch list metadata like list type, count, source, and status. Doesn't include users in the list.
Next
⌘I
Get all Lists
curl --request GET \
--url https://hub.suprsend.com/v1/subscriber_list/ \
--header 'Authorization: Bearer <token>'import requests
url = "https://hub.suprsend.com/v1/subscriber_list/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://hub.suprsend.com/v1/subscriber_list/', 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://hub.suprsend.com/v1/subscriber_list/",
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: Bearer <token>"
],
]);
$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://hub.suprsend.com/v1/subscriber_list/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://hub.suprsend.com/v1/subscriber_list/")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://hub.suprsend.com/v1/subscriber_list/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"meta": {
"count": 53,
"limit": 2,
"offset": 0
},
"results": [
{
"drafts": null,
"source": null,
"status": "active",
"list_id": "list_01",
"list_name": "sample list 01",
"list_type": "static_list",
"created_at": "2025-04-04T07:33:06.943+00:00",
"updated_at": "2025-04-04T07:33:06.943+00:00",
"version_id": null,
"is_readonly": false,
"track_user_exit": false,
"list_description": "_some sample description_",
"track_user_entry": false,
"subscribers_count": 0,
"requested_for_delete": false
},
{
"drafts": null,
"source": "database_sync",
"status": "active",
"list_id": "list_02",
"list_name": "sample list 02",
"list_type": "static_list",
"created_at": "2024-12-20T12:09:28.727+00:00",
"updated_at": "2025-04-04T07:32:32.127275+00:00",
"version_id": null,
"is_readonly": false,
"track_user_exit": true,
"list_description": "_some sample description_",
"track_user_entry": true,
"subscribers_count": 31,
"requested_for_delete": false
}
]
}"Not Authenticated - could not find Workspace details"