- Leadfeeder API
- Authentication
- Getting Started
- Rate Limits
- Relationships
- Company ID Lifecycle
- OpenAPI Specification Access
- List of NACE / WZ codes
- List of Industries
- AI & MCP
- Account
- Companies
- Retrieve Companies
- Create Company Enrichment Job
- Estimate Company Enrichment Job
- Get Company Enrichment Job Status
- Retrieve Company IPs
- Match Companies
- Search Companies
- Search Company Signals
- Get Company Details
- Update a Company
- Company Financial Reports
- Remove Company from Lists
- Add Company to Lists
- Unassign Tags from Company
- Assign Tags to Company
- Contacts
- Web Visits
- How to Create Custom Feed
- Custom Feed - Filter Reference
- Search Web Visits
- Retrieve Visitor Companies
- Retrieve Custom Feeds
- Create a Custom Feed
- Retrieve Custom Feeds Folders
- Delete a Custom Feed
- Get Custom Feed Details
- Update Custom Feed
- Retrieve Web Visits Tracker Script
- Retrieve Goals
- Create a Goal
- Delete a Goal
- Get Goal Details
- Update a Goal
- 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
- ConnectedListV1
- ContactV1
- ContactSummaryV1
- CookieConsentSettingsV1
- CountryV1
- CustomFeedFolderV1
- CustomFeedRequestV1
- CustomFeedV1
- CustomFieldV1
- EnrichedIpV1
- CRMUserV1
- DataProcessingSettingsV1
- CRMOrganizationV1
- ErrorObjectV1
- EnrichmentJobV1
- CRMContactV1
- GeoSuggestionV1
- FindContactDataJobV1
- CRMLeadV1
- ICPV1
- CRMConnectionV1
- IpAddressExtendedV1
- GoalCreateRequestV1
- CRMSuggestionV1
- IcpRequestV1
- IpLocationV1
- GoalUpdateRequestV1
- GoalV1
- CRMGroupConnectionV1
- ListV1
- LocationV1
- MaskedCompanySummaryV1
- NetworkV1
- MaskedContactSummaryV1
- SignalV1
- TagV1
- UserV1
- 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",
"relationships": {
"custom_feed": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"type": "custom_feed"
}
},
"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",
"relationships": {
"custom_feed": {
"id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"type": "custom_feed"
}
},
"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-10-13 07:27:21