SAsaleshandy
enrichment

List contacts already enriched or revealed in your account (Saved tab), with filters

Changed on

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.

post/v1/enrich/contact/saved

Request

Request body

startinteger

1-based position of the first contact to return. Page 1 is start=1; with take=25, page 2 is start=26.

takeinteger

Number of contacts to return per page. Maximum 25.

searchstring

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.

tagsstring[]

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.

createdDatestring[]

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.

excludeProspectsboolean

When true, hides contacts that have already been added as prospects.

emailStatusstring[]

Email verification status of the saved contact. Multiple values are OR-ed. valid: deliverable; risky: catch-all or uncertain; bad: undeliverable.

revealTypestring[]

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.

Example request

{
  "start": 1,
  "take": 25,
  "search": "john",
  "tags": [
    "VMw56r9jPb"
  ],
  "createdDate": [
    "01/10/2026",
    "07/10/2026"
  ],
  "emailStatus": [
    "valid"
  ],
  "revealType": [
    "workEmail"
  ],
  "listIds": {
    "includes": [
      "2dP27N0gZ4"
    ]
  }
}

Response

Saved contacts for the requested page. When nothing matches, payload is { "profiles": [] }.

messagestring

Example response

{
  "message": "Success",
  "payload": {
    "profiles": [
      {
        "id": 48213377,
        "full_name": "Jane Cooper",
        "job_title": "VP of Sales",
        "department": "Sales",
        "management_level": "VP",
        "company_name": "Acme Inc",
        "company_domain": "acme.com",
        "company_website": "https://acme.com",
        "company_industry": "Computer Software",
        "company_size_range": "201-500",
        "linkedin_url": "https://www.linkedin.com/in/janecooper",
        "location_country": "United States",
        "location_state": "California",
        "location_city": "San Francisco",
        "emails": [
          {
            "value": "jane.cooper@acme.com"
          }
        ],
        "personalEmails": [
          {
            "value": "jane.cooper@gmail.com"
          }
        ],
        "phones": [
          {
            "value": "+14155550123"
          }
        ],
        "revealType": "emailphone",
        "isProspectCreated": true,
        "tags": [
          {
            "id": "VMw56r9jPb",
            "name": "Hot lead"
          }
        ],
        "lists": [
          {
            "id": "2dP27N0gZ4",
            "name": "Q4 outreach"
          }
        ]
      }
    ]
  }
}

Changes