#Get contacts

Get contacts from 'All Contacts' or belonging to a list.

#Method

GET

#Path

/contacts

#Query string parameter

NameValueRequired?
list_id0 - to get all Contacts or
List ID - to get contacts from a specific list (Use /lists endpoint to get all the contact lists)
No
limitNumber of records to return. Max allowed value is 1000.No. Defaults to 1000.
offsetNumber of records to skip (for pagination).No. Defaults to 0.

#Response

#HTTP status codes

CodeRemarks
200Request was successful.
400Validation error or request body was incorrectly formatted.
401Authentication failed. Check apikey header.
404Requested API endpoint not found.
429The rate limit has been reached.
500-511There was a problem processing the request on our server. Try again later.

#Response object

NameValueRemarks
statussuccess or error-
errorsArray of object { msg: [error detail] }Only present when status is error.
dataArray of contact objects. Result is sorted by the contact ID in ascending order.Only present when status is success

#Code sample

curl --location --request GET 'https://api.sociocs.com/contacts?list_id=1000001&limit=100&offset=200' \ --header 'apikey: your_api_key' \