- Leadfeeder API
- Authentication
- Getting Started
- Rate Limits
- Relationships
- Company ID Lifecycle
- OpenAPI Specification Access
- List of NACE / WZ codes
- List of Industries
- AI & MCP (Beta)
- Account
- Companies
- Get Company Details
- Create Company Enrichment Job
- Estimate Company Enrichment Job
- Retrieve Companies
- Company Financial Reports
- Get Company Enrichment Job Status
- Retrieve Company IPs
- Match Companies
- Search Companies
- Search Company Signals
- Update a Company
- Remove Company from Lists
- Add Company to Lists
- Unassign Tags from Company
- Assign Tags to Company
- Contacts
- Web Visits
- Campaigns
- IP
- Buyer Personas
- Ideal Customer Profiles
- Tags
- Lists
- Custom Fields
- Users
- Settings
- Usage
- Reference Data
- Schemas
- AccountCompanyV1
- AccountSummaryV1
- AccountV1
- ApiUsageV1
- BatchAddTagsJobV1
- BatchAddToListJobV1
- BatchRemoveFromListJobV1
- BatchRemoveTagsJobV1
- BuyerPersonaRequestV1
- BuyerPersonaV1
- CampaignLocationV1
- CampaignSettingsV1
- CampaignStatsV1
- CampaignSummaryV1
- CampaignV1
- CompaniesAdvancedSearchFilterItem
- CompanyFinancialsV1
- CompanyIndustryV1
- CompanyLocationV1
- CompanyIpV1
- CompanyMatchV1
- CompanySummaryV1
- CompanyV1
- ContactFilterGroupsV1
- ContactSummaryV1
- ContactV1
- CookieConsentSettingsV1
- CountryV1
- CustomFeedFolderV1
- CustomFeedRequestV1
- CustomFeedV1
- CustomFieldV1
- DataProcessingSettingsV1
- EnrichedIpV1
- CRMUserV1
- ErrorObjectV1
- CRMOrganizationV1
- EnrichmentJobV1
- CRMContactV1
- GeoSuggestionV1
- FindContactDataJobV1
- CRMLeadV1
- ICPV1
- CRMConnectionV1
- IpAddressExtendedV1
- IcpRequestV1
- CRMSuggestionV1
- IpLocationV1
- CRMGroupConnectionV1
- LocationV1
- ListV1
- MaskedCompanySummaryV1
- MaskedContactSummaryV1
- NetworkV1
- SignalV1
- UserV1
- TagV1
- VisitLocationV1
- WebVisitV1
- WebVisitsTrackerScriptV1
Retrieve Company ICP Matches
POST
/v1/icps/companies
ids and get one entry per company, in the same order.include=icps to get each ICP's full details instead — the same fields Retrieve Ideal Customer Profiles returns — so you do not need a second call to resolve names. An ICP matched by several of the requested companies is repeated under each of them.INFO
icps:read OAuth2 scope.Request
Authorization
API Key
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************or
Query Params
Body Params application/jsonRequired
Example
{
"ids": [
"159001425",
"129011"
]
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.leadfeeder.com/v1/icps/companies?account_id=123456&include=undefined' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"ids": [
"159001425",
"129011"
]
}'Responses
🟢200OK
application/json
Bodyapplication/json
Examples
{
"data": [
{
"id": "159001425",
"relationships": {
"icps": [
{
"attributes": {
"created_at": "2024-12-10T15:57:25Z",
"filters": {
"employee_count": [
{
"display_value": "51-200",
"negated": false,
"search_value": "51-200"
}
],
"location": [
{
"display_value": "United States",
"negated": false,
"search_value": "US",
"type": "country_code"
}
]
},
"name": "US Prospects"
},
"id": "6080",
"type": "icp"
},
{
"attributes": {
"created_at": "2025-02-03T08:41:12Z",
"filters": {
"location": [
{
"display_value": "Germany",
"negated": false,
"search_value": "DE",
"type": "country_code"
}
]
},
"name": "DACH Mid-Market"
},
"id": "6081",
"type": "icp"
}
]
},
"type": "company"
},
{
"id": "129011",
"relationships": {
"icps": []
},
"type": "company"
}
],
"meta": {
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠429
🔴500Server Error
🔴504Gateway Timeout
Modified at 2026-09-17 07:46:23