--- title: "List contacts" method: GET path: "/v1/contacts/" tags: ["contacts"] --- # List contacts `GET /v1/contacts/` Retrieve a paginated list of contacts for the authenticated user. Supports cursor-based pagination, sorting, and filtering by archived status. ## Query parameters - `take` integer - `skip` integer - `cursor` string, uuid - `where` object - `in` union - string, uuid - string[] - `not_in` union - string, uuid - string[] - `ignore_merge` boolean - `is_starred` boolean - `is_archived` boolean - `has_priority_tier` union - integer - integer[] - boolean - `has_linkedin` union - string - boolean - `has_instagram` union - string - boolean - `has_twitter` union - string - boolean - `has_source` union - string - string[] - `has_name` union - string - string[] - object - `contains` string, required - object - `eq` string, required - `has_groups` union - object - `not` union, required - string - string[] - boolean - string, uuid - string[] - `has_groups_all` array[] - string[] - `has_frequency` union - string - boolean - `has_location` union - string - boolean - `has_location_exact` string - `has_job_title` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_never_keep_in_touch` boolean - `has_created_at` object - `gte` string, date-time - `lte` string, date-time - `has_updated_at` object - `gte` string, date-time - `lte` string, date-time - `has_birthday` union - string, date-time - unknown - boolean - `has_tag` string, uuid - `has_tags` union - string[] - object - `not` union, required - string, uuid - string[] - `has_tags_all` array[] - string[] - `has_company` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_education` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_description` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_linkedin_companies` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_linkedin_education` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_email` boolean - `has_phone_number` boolean - `not_has_name` union - string - string[] - `not_has_company` union - string - string[] - `not_has_job_title` union - string - string[] - `not_has_education` union - string - string[] - `not_has_description` union - string - string[] - `not_has_linkedin_companies` union - string - string[] - `not_has_linkedin_education` union - string - string[] - `has_linkedin_last_message_at` union - boolean - object - `gte` string, date-time - `lte` string, date-time - `has_last_seen_at` union - boolean - object - `gte` string, date-time - `lte` string, date-time - `has_distance` object - `lat` number, required - `lon` number, required - `meters` number, required - `has_interaction` union - boolean - object - `gte` string, date-time - `lte` string, date-time - `has_next_reminder` union - boolean - object - `gte` string, date-time - `lte` string, date-time - `custom_fields` object[] - `field_id` string, uuid, required - `operator` 'contains' | 'eq' | 'in' | 'not_in' | 'present' | 'absent' | 'gte' | 'lte', required - `value` union - string - string[] - `_or` object[] - `in` union - string, uuid - string[] - `not_in` union - string, uuid - string[] - `ignore_merge` boolean - `is_starred` boolean - `is_archived` boolean - `has_priority_tier` union - integer - integer[] - boolean - `has_linkedin` union - string - boolean - `has_instagram` union - string - boolean - `has_twitter` union - string - boolean - `has_source` union - string - string[] - `has_name` union - string - string[] - object - `contains` string, required - object - `eq` string, required - `has_groups` union - object - `not` union, required - string - string[] - boolean - string, uuid - string[] - `has_groups_all` array[] - string[] - `has_frequency` union - string - boolean - `has_location` union - string - boolean - `has_location_exact` string - `has_job_title` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_never_keep_in_touch` boolean - `has_created_at` object - `gte` string, date-time - `lte` string, date-time - `has_updated_at` object - `gte` string, date-time - `lte` string, date-time - `has_birthday` union - string, date-time - unknown - boolean - `has_tag` string, uuid - `has_tags` union - string[] - object - `not` union, required - string, uuid - string[] - `has_tags_all` array[] - string[] - `has_company` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_education` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_description` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_linkedin_companies` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_linkedin_education` union - string - boolean - object - `contains` string, required - object - `eq` string, required - `has_email` boolean - `has_phone_number` boolean - `not_has_name` union - string - string[] - `not_has_company` union - string - string[] - `not_has_job_title` union - string - string[] - `not_has_education` union - string - string[] - `not_has_description` union - string - string[] - `not_has_linkedin_companies` union - string - string[] - `not_has_linkedin_education` union - string - string[] - `has_linkedin_last_message_at` union - boolean - object - `gte` string, date-time - `lte` string, date-time - `has_last_seen_at` union - boolean - object - `gte` string, date-time - `lte` string, date-time - `has_distance` object - `lat` number, required - `lon` number, required - `meters` number, required - `has_interaction` union - boolean - object - `gte` string, date-time - `lte` string, date-time - `has_next_reminder` union - boolean - object - `gte` string, date-time - `lte` string, date-time - `custom_fields` object[] - `field_id` string, uuid, required - `operator` 'contains' | 'eq' | 'in' | 'not_in' | 'present' | 'absent' | 'gte' | 'lte', required - `value` union - string - string[] - `orderBy` unknown - `include` object - `linkedin_data` boolean - `groups_count` boolean - `coordinates` boolean - `select` object - `linkedin_data` boolean - `groups_count` boolean - `coordinates` boolean ## Response `200` Successful response - object - `error` boolean, required - `data` object, required - `items` object[], required - `id` string, uuid, required - `user_id` string - `first_name` string, nullable - `last_name` string, nullable - `full_name` string, nullable - `description` string, nullable - `job_title` string, nullable - `company` string, nullable - `education` string, nullable - `legacy_location` string, nullable - `image_url` string, nullable - `business_card_url` string, nullable - `website` string, nullable - `image_source` string, nullable - `birthday` union - string, date-time - unknown - `birthday_year` integer, nullable - `linkedin` string, nullable - `twitter` string, nullable - `facebook` string, nullable - `instagram` string, nullable - `telegram` string, nullable - `tiktok` string, nullable - `youtube` string, nullable - `starred` boolean - `is_archived` boolean - `ignore_merge` boolean - `never_keep_in_touch` boolean - `source` string - `priority_tier` integer, nullable - `frequency` string, nullable - `frequency_text` string, nullable - `last_seen_at` union - string, date-time - unknown - `last_reminder_at` union - string, date-time - unknown - `next_reminder_at` union - string, date-time - unknown - `linkedin_companies` string, nullable - `linkedin_education` string, nullable - `linkedin_enhance_date` union - string, date-time - unknown - `linkedin_last_message_at` union - string, date-time - unknown - `linkedin_last_message_snippet` string, nullable - `linkedin_message_link` string, nullable - `whatsapp_message_link` string, nullable - `whatsapp_message_snippet` string, nullable - `whatsapp_last_message_at` union - string, date-time - unknown - `imessage_message_link` string, nullable - `imessage_message_snippet` string, nullable - `imessage_last_message_at` union - string, date-time - unknown - `instagram_message_link` string, nullable - `instagram_message_snippet` string, nullable - `instagram_last_message_at` union - string, date-time - unknown - `gmail_last_interaction_at` union - string, date-time - unknown - `gmail_last_interaction_provider` 'GOOGLE' | 'OFFICE365', nullable - `gmail_last_interaction_provider_id` string, nullable - `gmail_last_interaction_subject` string, nullable - `gcal_last_interaction_at` union - string, date-time - unknown - `gcal_last_interaction_provider` 'GOOGLE' | 'OFFICE365', nullable - `gcal_last_interaction_provider_id` string, nullable - `gcal_last_interaction_title` string, nullable - `phone_call_interaction_snippet` string, nullable - `phone_call_last_interaction_at` union - string, date-time - unknown - `web_search_summary` unknown - `created_at` union - string, date-time - unknown - `updated_at` union - string, date-time - unknown - `geocode_attempts` integer - `geocode_failed_at` union - string, date-time - unknown - `_count` object - `groups_contacts` integer, required - `frequency_interval` unknown - `linkedin_data` object, nullable - `latitude` number, nullable - `longitude` number, nullable - `contact_emails` object[] - `contact_phone_numbers` object[] - `contact_birthdays` object, nullable - `contact_locations` object[] - `contacts_custom_fields` object[] - `legacy_contact_addresses` object[] - `groups_contacts` object[] - `tags_contacts` object[] - `timeline_items_contacts` object[] - `reminders_contacts` object[] - `contact_relations_contact_relations_sourceTocontacts` object[] - `contact_relations_contact_relations_destinationTocontacts` object[] - `feed_items` object[] - `keep_in_touch_reminders` object, nullable - `nextCursor` string, nullable - `count` integer, required ## Other responses - `400` — Request body failed validation. - `401` — Missing or invalid API key. - `403` — Valid key, insufficient permission. - `404` — Resource does not exist. - `429` — Rate limit exceeded. - `500` — Unexpected server error. --- [API](https://skmtc.dev/getdex/apis/dex-public-api.md) · [All operations](https://skmtc.dev/getdex/apis/dex-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getdex/dex-public-api/revisions/79f990e752ad/schema)