Parameters
page
number
RequiredDescription
Page number for pagination.
per_page
number
Description
Number of records per page (1-100). Default is 30.
GET/v1/lists
bash
curl https://api.tradly.app/v1/lists \
-H "Authorization: Bearer YOUR_PUBLISHABLE_OR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{}'RESPONSE
json
{
"status": true,
"data": {
"total_records": 2,
"page": 1,
"lists": [
{
"id": "list_abc123",
"name": "Newsletter Subscribers",
"description": "Opted-in newsletter contacts",
"member_count": 342,
"created_at": 1723068000,
"updated_at": 1723068000
},
{
"id": "list_def456",
"name": "Spring Campaign 2026",
"description": null,
"member_count": 88,
"created_at": 1723154400,
"updated_at": 1723154400
}
]
}
}