--- title: "List contacts already enriched or revealed in your account (Saved tab), with filters" method: POST path: "/v1/enrich/contact/saved" tags: ["enrichment"] --- # List contacts already enriched or revealed in your account (Saved tab), with filters `POST /v1/enrich/contact/saved` ## Request - Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from) - URL: `https://developer.saleshandy.com/v1/enrich/contact/saved` - Auth: API key in header `x-api-key` - TypeScript: (a function with typed inputs; its response is checked against the schema) Lists contacts that have already been revealed or enriched in your account, the same contacts shown in the **Saved** tab of Saleshandy Lead Finder, including those enriched via the **Enrich Contacts** API. This endpoint does not consume credits. **Pagination:** use `start` (1-based) and `take` (max 25). The response has no total count; when fewer than `take` contacts are returned you have most likely reached the last page. Results are ordered newest first, so contacts saved while you paginate can shift pages. **Hashed IDs:** `tags` and `listIds.includes` take hashed IDs that you can copy from the Saved tab in the app. Only tags already applied to at least one saved contact or company are listed there. List IDs you do not have access to are ignored; if none of the given lists are accessible the request fails with 400. The `id` values returned in `tags` and `lists` are hashed in the same format, so they can be passed back directly as `tags` and `listIds.includes` filters. **Dates:** `createdDate` is interpreted in the timezone of the user who owns the API key, or America/New_York if that user has no timezone set. **Empty pages:** an empty `profiles` array normally means no more matches, but can also be returned during a temporary backend issue. Retry once before treating an unexpected empty page as the end of the results. ## Request body - ViewEnrichedContactsDto - `start` integer: 1-based position of the first contact to return. Page 1 is `start=1`; with `take=25`, page 2 is `start=26`. - `take` integer: Number of contacts to return per page. Maximum 25. - `search` string: Free-text search across the saved contact, e.g. first name, last name, full name, email, company. It is not a prefix search. It has to match the whole word to give right results. - `tags` string[]: Hashed tag IDs. Returns contacts that have **any** of these tags. Copy a tag ID from the Saved tab in the Saleshandy app; only tags already applied to at least one saved contact or company appear there. Max 100. - `createdDate` string[]: Date range in which the contact was saved, as `[from, to]` in `dd/mm/yyyy` format. Both dates are inclusive and interpreted in the timezone of the user who owns the API key (America/New_York if none is set). `from` must be on or before `to`, and both dates must be between 01/01/2015 and today. - `excludeProspects` boolean: When `true`, hides contacts that have already been added as prospects. - `emailStatus` string[]: Email verification status of the saved contact. Multiple values are OR-ed. `valid`: deliverable; `risky`: catch-all or uncertain; `bad`: undeliverable. - `revealType` string[]: What was revealed for the contact. Multiple values are OR-ed. `profileOnly`: profile data only, no contact details; `workEmail`: a work email was revealed; `phone`: a phone number was revealed; `personalEmail`: a personal email was revealed; `imported`: the contact was imported from a CSV file. - `listIds` SavedContactsListIdsDto - `includes` string[], required: Hashed list IDs. Returns contacts saved in **any** of these lists. Copy a list ID from the Saved tab in the Saleshandy app (People lists). Lists you do not have access to are ignored; if none of the given lists are accessible the request fails with 400. Max 100. ## Response `200` Saved contacts for the requested page. When nothing matches, `payload` is `{ "profiles": [] }`. - object - `message` string - `payload` object - `profiles` object[]: Saved contacts for this page. Empty array when nothing matches. - `id` number: Lead ID (usable with Enrich Contacts `lead_id`). - `full_name` string - `job_title` string - `department` string - `management_level` string - `company_name` string - `company_domain` string - `company_website` string - `company_industry` string - `company_size_range` string - `linkedin_url` string - `location_country` string - `location_state` string - `location_city` string - `picture_url` string, nullable - `emails` object[]: Revealed work emails. - `value` string - `source` string: Data source of this value. - `isLatest` boolean: Whether this is the most recently revealed value. - `personalEmails` object[]: Revealed personal emails. - `value` string - `source` string: Data source of this value. - `isLatest` boolean: Whether this is the most recently revealed value. - `phones` object[]: Revealed phone numbers. - `value` string - `source` string: Data source of this value. - `isLatest` boolean: Whether this is the most recently revealed value. - `revealType` string: What was revealed for this contact. - `isProspectCreated` boolean: Whether this contact has been added as a prospect. - `tags` object[]: Tags applied to this contact. `id` is a hashed tag ID, usable in the `tags` filter. - `id` string - `name` string - `lists` object[]: Lists this contact is saved in. `id` is a hashed list ID, usable in the `listIds.includes` filter. - `id` string - `name` string ## Other responses - `400`: 1001: Invalid tag id

1001: Invalid list id

1001: Invalid date format provided

1001: Start date must be on or before end date

1001: None of the provided list IDs are accessible

4000: Failed to fetch enriched contacts

1001: Invalid token

## Changes - **2026-10-23** `e7a29c931aa7`: 1 info - endpoint added [Operation history](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/changes/v1/enrich/contact/saved/post.md) --- [API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)