Skip to main content
GET
PublicApiListContacts
Use this endpoint through the Developer API or the matching firstsales CLI command when available. Responses use the stable FirstSales public error envelope.

Authorizations

Authorization
string
header
required

FirstSales developer API key bearer token (fs-key-*).

Path Parameters

orgId
string
required
wsId
string
required

Query Parameters

page
integer
default:1
Required range: x >= 1
limit
integer
default:10
Required range: 1 <= x <= 100
sortBy
enum<string>
default:createdAt
Available options:
createdAt,
email,
firstName,
company
sortOrder
enum<string>
default:desc
Available options:
asc,
desc
Maximum string length: 100
status
enum<string>
Available options:
active,
bounced,
unsubscribed
source
enum<string>
Available options:
csv-import,
ai-leads,
webhook,
signal,
manual
tags
string
Maximum string length: 500
company
string
Maximum string length: 200
listId
string
Pattern: ^[0-9a-fA-F]{24}$
verificationStatus
enum<string>
Available options:
clean,
risky,
dirty,
unknown
mobileOnly
boolean

Response

Successful response

contacts
object[]
required
pagination
object
required