View Enriched Companies
POST /v1/enrich/company/saved
/v1/enrich/company/savedList companies already saved or enriched in your account (Saved tab), with filters
Lists companies already saved in your account, the same companies shown in the Saved tab of Saleshandy Lead Finder (Companies), including those enriched via the Enrich Companies API or added via Import List. This endpoint does not consume credits.
Pagination: use start (1-based) and take (max 25). The response includes pagination: { start, next } and no total count. Pass pagination.next as the next start. A page can contain fewer than take companies even when more exist, so do not stop on a short page. Stop only when companies is empty and pagination.next equals the start you sent; if companies is empty but next is larger, continue from next. Results are ordered newest first, so companies saved while you paginate can shift pages.
Temporary failures: if pagination.next is 0, the request could not be completed due to a temporary backend issue. Retry the same start; this is not the end of the results.
Hashed IDs: tags and listIds.includes take hashed IDs that you can copy from the Saved tab in the app. listIds accepts company lists only. 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.
Data visibility: companies saved without enrichment (notEnriched) may return preview data only, with other fields empty, depending on your plan.
Authorization
x-api-key<token>
API key for Open API authentication
In: header
Request Body
application/jsonRequiredstartinteger
1-based position of the first company to return. Page 1 is start=1. For the next page pass the pagination.next value from the previous response (with take=25, page 2 is start=26).
1Default: 1Minimum: 1takeinteger
Number of companies to return per page. Maximum 25.
Example:25Default: 25Minimum: 1Maximum: 25searchstring
Free-text search across saved companies, e.g. company name or domain.
Example:"acme"tagsarray<string>
Hashed tag IDs. Returns companies that have any of these tags. Copy a tag ID from the Saved tab in the Saleshandy app. Max 100.
Example:["VMw56r9jPb"]createdDatearray<string>
Date range in which the company 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.
["01/10/2026","07/10/2026"]revealTypearray<string>
How the company was saved. Multiple values are OR-ed. enriched: full company data was enriched (credits used); notEnriched: saved without enrichment, only preview data is available; imported: added via Import List and not enriched since.
["enriched"]listIdsobject
Filter by the company lists the company is saved in. Max 100
Responses
{
"message": "Success",
"payload": {
"companies": [
{
"company_id": 1234567,
"company_name": "Acme Inc",
"company_logo_url": "https://logo.example.com/acme.png",
"internalId": 98765,
"revealType": "enriched",
"company_size_range": "51-200",
"company_locations": [
"San Francisco, CA, United States"
],
"employees_count_by_department": {
"sales": 12,
"technical": 40
},
"employees_count_by_seniority": {
"director": 5,
"manager": 14
},
"employee_reviews": {},
"tags": [
{
"id": "VMw56r9jPb",
"name": "Q4 targets"
}
],
"lists": [
{
"id": "2dP27N0gZ4",
"name": "Q4 targets"
}
],
"revealFeedback": {
"sentiment": "string",
"message": "string"
}
}
],
"pagination": {
"start": 1,
"next": 26
}
}
}