Skip to main content
GET
/
v1
/
contact-lists
/
csv
Get all CSV contact lists
curl --request GET \
  --url https://client-api.salesfinity.co/v1/contact-lists/csv \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "_id": "<string>",
      "name": "<string>",
      "user": "<string>",
      "total_contacts": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "total": 123,
    "page": 123,
    "next": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.salesfinity.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

ParameterTypeDescription
searchstringSearch lists by name (case-insensitive)
filters[user]stringFilter by user ID
sortstringSort by field. Prefix with - for descending. Default: -createdAt. Examples: name, -updatedAt
pagenumberPage number. Default: 1
limitnumberItems per page. Default: 10

​
Response

Returns a paginated array of contact lists:
FieldTypeDescription
_idstringUnique identifier of the contact list
namestringName of the list
userstringID of the user who owns the list
total_contactsnumberNumber of contacts in the list
createdAtstringDate the list was created
updatedAtstringDate the list was last updated

​
Example Requests

# Get all lists
GET /v1/contact-lists/csv

# Search by name
GET /v1/contact-lists/csv?search=outbound

# Filter by user
GET /v1/contact-lists/csv?filters[user]=680edc0d1504192884a148e0

# Sort by name ascending
GET /v1/contact-lists/csv?sort=name

# Combine filters
GET /v1/contact-lists/csv?search=q2&filters[user]=680edc0d1504192884a148e0&sort=-createdAt&page=1&limit=20

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
search
string

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

200 - application/json

CSV contact lists retrieved successfully

​
data
object[]
​
pagination
object