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
  }
}
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