Skip to main content
GET
Get a contact list
Returns a single CSV contact list with all its contacts. Supports searching, sorting, and paginating the contacts within the list.

Path Parameters

  • id (required, string): CSV contact list ID

Query Parameters

Response

Returns the list metadata and a paginated array of contacts: Each contact object includes:

Example Requests

Errors

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.

Path Parameters

id
string
required

CSV contact list ID

Query Parameters

Search contacts by first name, last name, email, or company

sort
string

Sort contacts by field. Prefix with - for descending

page
integer
default:1

Page number for contacts

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

Contacts per page

Required range: x >= 1

Response

CSV contact list retrieved successfully

data
object
pagination
object