List contacts
Find CRM contacts and inspect pagination.
Personal token scopes: contacts:read. Your account must also have access to the requested data. Authentication
List contacts
Sorting
Supported sort-order:
-
id -
display_name -
name -
first_name -
last_name -
email -
primary_email -
employees.count -
organisations.company_name -
relevance -
created_at -
modified_at -
coverage_number -
last_coverage_at -
stat_sent -
stat_clicked -
stat_clicked_rate -
stat_opened -
stat_opened_rate -
stat_replied -
discord -
facebook -
instagram -
klout -
linkedin -
pinterest -
skype -
snapchat -
twitch -
twitter -
youtube -
address.country -
address.region -
address.city -
address.zip -
address.street
See Ordering Resullts for details.
Personal access tokens: contacts:read. Every listed scope is required; the token owner's permissions, feature availability and newsroom access still apply.
API_keyAuthorizationBearer <token>Bearer authentication using an integration API key, or a personal access token only where the operation explicitly supports it. Every listed personal-token scope is required; owner permissions and newsroom access still apply.
query?stringA JSON-formatted string of a Prezly Query Language object for filtering items
offset?integerNumber of records to skip (for pagination)
limit?integerNumber of records to fetch
1 <= value <= 100020sort?stringSee Ordering Results
[-+]?(\w+\.)*\w+search?stringKeyword to use for full text search
OK
application/json- response
contacts*array<>pagination*sort*Sort OrderSort order to return records in.
[+-]?(\w+\.)*\w+curl -X GET 'https://api.prezly.com/v2/contacts'{ "contacts": [ { "id": 0, "contact_type": "person", "is_person": true, "is_deleted": true, "salutation": "string", "custom_fields": { "property1": "string", "property2": "string" }, "company_name": "string", "first_name": "string", "last_name": "string", "gender": "string", "display_name": "string", "avatar_url": "string", "avatar_image": { "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "version": 0, "filename": "string", "mime_type": "string", "size": 0, "original_width": 0, "original_height": 0, "effects": [ "string" ] }, "bio": "string", "primary_email": "user@example.com", "emails": [ "user@example.com" ], "phone_numbers": [ { "type": "cell", "number": "string" } ], "social": [ { "type": "bluesky", "username": "string" } ], "urls": [ "http://example.com" ], "function_name": "string", "periodicity": "daily", "medium_types": [ "wire" ], "address": { "street": "string", "number": "string", "box": "string", "zip": "string", "city": "string", "region": "string", "country": "string" }, "address_text": "string", "coverage_number": 0, "last_coverage_at": "2019-08-24T14:15:22Z", "organisations_number": 0, "organisations": [ { "id": 0, "display_name": "string", "links": { "view": "http://example.com" } } ], "employees_number": 0, "tags": [ "string" ], "is_bounced": true, "is_duplicated": true, "is_unsubscribed": true, "is_unsubscribed_from_all_communications": true, "has_enrichments": true, "unsubscribed_newsrooms": [ "string" ], "duplicate_contacts": [ { "contact": { "id": 0, "contact_type": "person", "display_name": "string", "function_name": "string", "avatar_url": "http://example.com", "is_deleted": true, "links": { "api": "http://example.com", "view": "http://example.com" } }, "score": 0, "status": "unseen", "links": { "merge_api": "http://example.com" } } ], "created_at": "2019-08-24T14:15:22Z", "modified_at": "2019-08-24T14:15:22Z", "stats": { "sent": 0, "replied": 0, "clicked": 0, "clicked_rate": 0, "opened": 0, "opened_rate": 0 }, "meta": { "is_unsubscribed": true, "is_bounced": true, "is_duplicated": true }, "links": { "api": "http://example.com", "view": "http://example.com", "edit": "http://example.com", "convert": "http://example.com", "exclude_mailbox_conversations": "http://example.com", "organisations_api": "http://example.com", "employees_api": "http://example.com", "enrichments_api": "http://example.com", "duplicates_api": "http://example.com", "data_privacy_requests_api": "http://example.com", "export_personal_data_api": "http://example.com" }, "tag_entities": [ { "id": 0, "name": "string" } ] } ], "pagination": { "offset": 0, "limit": 0, "matched_records_number": 0, "total_records_number": 0 }, "sort": "+display_name"}