--- title: "List companies already saved or enriched in your account (Saved tab), with filters" method: POST path: "/v1/enrich/company/saved" tags: ["enrichment"] --- # List companies already saved or enriched in your account (Saved tab), with filters `POST /v1/enrich/company/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/company/saved` - Auth: API key in header `x-api-key` - TypeScript: (a function with typed inputs; its response is checked against the schema) 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. ## Request body - ViewEnrichedCompaniesDto - `start` integer: 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`). - `take` integer: Number of companies to return per page. Maximum 25. - `search` string: Free-text search across saved companies, e.g. company name or domain. - `tags` 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. - `createdDate` 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`. - `revealType` 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. - `listIds` SavedCompaniesListIdsDto - `includes` string[], required: Hashed company list IDs. Returns companies saved in **any** of these lists. Copy a list ID from the Saved tab in the Saleshandy app (Company lists). People lists are not accepted. 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 companies for the requested page with pagination. When nothing matches, `payload` is `{ "companies": [], "pagination": { "start": , "next": } }`. - object - `message` string - `payload` object - `companies` object[]: Saved companies for the requested page, newest first. Empty when no companies match. - `company_id` integer: Lead Finder company ID. - `company_name` string - `company_logo_url` string: Company logo URL. - `internalId` integer: Saleshandy internal ID of the saved company. - `revealType` 'enriched' | 'notEnriched' | 'imported': How the company was saved. - `company_size_range` string - `company_locations` string[] - `employees_count_by_department` object - `employees_count_by_seniority` object - `employee_reviews` object: Aggregated employee review scores, when available. - `tags` object[]: Tags applied to the company. `id` is a hashed tag ID, usable in the `tags` filter. - `id` string: Hashed ID. - `name` string - `lists` object[]: Company lists the company belongs to. `id` is a hashed list ID, usable in the `listIds.includes` filter. - `id` string: Hashed ID. - `name` string - `revealFeedback` object, nullable - `sentiment` string, nullable - `message` string, nullable - `pagination` object: `start` echoes the requested start. `next` is the `start` to send for the following page; `next` equal to `start` with no companies means the end, and `next: 0` means a temporary failure (retry). - `start` integer - `next` integer ## 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 companies

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/company/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)