Skip to main content
GET
List contact lists
Returns all CSV contact lists for the team. This is the primary endpoint for listing your contact lists. Returns metadata only — use Get List by ID to see the contacts inside a list.

Query Parameters

Response

Returns a paginated array of contact lists:

Example Requests

Authorizations

x-api-key
string
header
required

Team-scoped API key generated in the Salesfinity dashboard under Settings -> Connections & API. A missing or invalid key returns HTTP 403.

Query Parameters

Search lists by name (case-insensitive)

filters[user]
string

Filter by user ID

sort
string

Sort field. Prefix with - for descending. Default: -createdAt

page
integer
default:1

Page number

Required range: x >= 1
limit
integer
default:10

Items per page

Required range: 1 <= x <= 100

Response

CSV contact lists retrieved successfully

data
object[]
pagination
object