Retrieve Companies
Changed onRetrieve the list of companies based on provided IDs. Credit Note: Each company will contain it's full deep data and it will consumes 1 credit, unless the company was already accessed within the last 12 months.
:::info Requires the companies:read OAuth2 scope. :::
Request
- Base URLhttps://api.leadfeeder.com
- URLhttps://api.leadfeeder.com/v1/companies
- Auth
- API key in header X-Api-Key
- or OAuth 2Authorization code: https://api.leadfeeder.com/v1/oauth/authorizeToken URL: https://api.leadfeeder.com/v1/oauth/token scopes: companies:read
Query parameters
Comma separated list of company IDs. A maximum of 100 IDs can be passed to this endpoint. Note that the older string-based ID format continues to be supported.
The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
Specify which additional data should be attached to the result.
Response
Success
Example response
{
"data": [
{
"attributes": {
"address": {
"city": "Karlsruhe",
"country": "Germany",
"country_code": "DE",
"geo": {
"latitude": 49.01,
"longitude": 8.43
},
"postal_code": "76131",
"region": "Baden-Württemberg",
"region_code": "DE1",
"street_address": "Durlacher Allee 73",
"street_name": "Durlacher Allee",
"street_number": "73"
},
"alternative_names": [
"Echobot Media Technologies GmbH",
"Dealfront"
],
"alternative_urls": [
"https://echobot.de",
"https://dealfront.com"
],
"app_url": "https://app.leadfeeder.com/h/company/129011",
"description": "Dealfront is the Go-to-Market Platform giving sales and marketing teams the data, applications, and insights they need to win any European market",
"earnings": {
"currency": "EUR",
"value": 9694333,
"year": 2020
},
"emails": [
{
"address": "info@leadfeeder.com"
}
],
"employee_count": 271,
"employee_range": "101-500",
"founded_year": 2017,
"industries": {
"industry": [
{
"code": "62.01",
"name": "Software Development"
}
],
"nace": [
{
"code": "62.01.9",
"name": "Computer programming activities"
}
],
"wz": [
{
"code": "62.01.9",
"name": "Computer programming activities"
}
]
},
"intent": {
"last_updated_at": "2026-03-05T12:41:44Z",
"score": 7.5,
"score_tier": "high"
},
"keywords": [
"Strategy",
"Technology",
"Software Solutions",
"Marketing",
"B2b"
],
"legal_form": "Limited",
"logo_url": "https://app.dealfront.com/logos/200/694ad7b1-lf-logo-2026-04-16.jpg",
"meta": {
"num_contacts": 99
},
"name": "Dealfront Group GmbH",
"net_worth": {
"currency": "EUR",
"value": 9694333,
"year": 2020
},
"orientation": [
"B2B"
],
"phones": [
{
"number": "+49 721 50057501",
"type": "landline"
}
],
"previous_ids": [
"185907485",
"221290577",
"223757669",
"223760732"
],
"register": {
"id": "HRB711540",
"location": "Mannheim",
"status": "active"
},
"revenue": {
"currency": "EUR",
"value": 9694333,
"value_eur": 9694333,
"year": 2020
},
"role": "group_member",
"social_media_profiles": {
"facebook": [
{
"url": "https://www.facebook.com/getdealfront"
}
],
"instagram": [
{
"url": "https://instagram.com/getdealfront"
}
],
"linkedin": [
{
"url": "https://www.linkedin.com/company/dealfront"
}
],
"pinterest": [],
"twitter": [
{
"url": "https://twitter.com/getdealfront"
}
],
"xing": [],
"youtube": []
},
"url": "https://www.leadfeeder.com/welcome",
"vat_id": "DE276265194",
"web_engagement": {
"last_visit_date": "2026-03-05T12:41:44Z"
}
},
"id": "129011",
"relationships": {
"crm_connections": [
{
"relationships": {
"crm_record": {
"relationships": {
"crm_owner": {
"type": "crm_user"
}
},
"type": "crm_organization"
}
},
"type": "crm_connection"
}
],
"crm_group_connections": [
{
"relationships": {
"company": {
"type": "company"
},
"crm_connection": {
"type": "crm_connection"
}
},
"type": "crm_group_connection"
}
],
"crm_suggestions": [
{
"relationships": {
"crm_record": {
"relationships": {
"crm_owner": {
"type": "crm_user"
}
},
"type": "crm_organization"
}
},
"type": "crm_suggestion"
}
],
"group_company": {
"id": "129011"
},
"icps": [
{
"attributes": {
"created_at": "2024-12-10T15:57:25Z",
"filters": {
"employee_count": [
{
"display_value": "United States",
"search_value": "US"
}
],
"industries": [
{
"display_value": "United States",
"search_value": "US"
}
],
"location": [
{
"display_value": "United States",
"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"
}
],
"lists": [
{
"attributes": {
"created_at": "2024-12-10T15:57:25Z",
"name": "US Prospects",
"scope": "company",
"updated_at": "2024-11-24T11:50:00Z"
},
"id": "company_123",
"relationships": {
"created_by": {
"id": "12345"
}
},
"type": "list"
}
],
"tags": [
{
"attributes": {
"created_at": "2024-12-10T15:57:25Z",
"name": "Prospects",
"updated_at": "2024-11-24T11:50:00Z"
},
"id": "4b7e2c9f",
"relationships": {
"created_by": {
"id": "12345"
}
},
"type": "tag"
}
],
"web_visits": [
{
"attributes": {
"campaign": "HomePage Split",
"device_type": "smartphone",
"engagements": [
{
"hostname": "www.leadfeeder.com",
"id": "b4ebc08c-8c1f-11f1-9b9e-633b755451a0_0",
"page": {
"path": "/pricing/",
"title": "Pricing for all stages of growth",
"url": "http://www.leadfeeder.com/pricing/"
},
"previous_page_path": "(entrance)",
"time": "2026-07-29T05:00:00+02:00",
"time_on_page": 22
}
],
"identifiers": {
"adobe_cookies": [
{
"MCAAMB": "RKh123Vc5",
"MCAAMLH": "6",
"MCMID": "681245"
}
],
"ga_client_ids": [
"5829104736.1742616961"
],
"lf_client_id": "LF1.1.a3f8b2d1e4c90123.1742597607000"
},
"keyword": "website leads",
"landing_page_path": "/home",
"medium": "cpc",
"page_depth": 4,
"referring_url": "https://www.google.com/search?q=dealfront",
"source": "google",
"started_at": "2026-01-15T10:30:00.000Z",
"visit_length": 80,
"visitor": {
"email": "john.doe@example.com",
"first_name": "John",
"last_name": "Doe"
}
},
"id": "5b4f313e-46de-11e8-b981-05bebed8e58b",
"relationships": {
"company": {
"id": "129011"
},
"location": {
"attributes": {
"city": "Helsinki",
"country": "Finland",
"country_code": "FI",
"geonames_id": "658225",
"region": "Uusimaa"
},
"id": "6xeTMh2VfiAzFd86n7GNJ3",
"type": "visit_location"
}
},
"type": "web_visit"
}
]
},
"type": "company"
}
],
"meta": {
"credits": {
"charged": 1
},
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}Changes
- info
added the optional property
//////to the response with the status - info
added the optional property
////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
////////////////////////to the response with the status - info
added the optional property
////////////////////////to the response with the status - info
added the optional property
////////////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
////////////////////////to the response with the status - info
added the optional property
////////////////////////to the response with the status - info
added the optional property
////////////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
////////////////////////to the response with the status - info
added the optional property
////////////////////////to the response with the status - info
added the optional property
////////////////////////to the response with the status - info
added the optional property
////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
added the optional property
//////////////////to the response with the status - info
response property
data/items/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_namedeprecated - info
response property
data/items/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_namedeprecated - info
response property
data/items/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_codedeprecated - info
response property
data/items/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_namedeprecated - info
response property
data/items/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_namedeprecated - info
response property
data/items/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_namedeprecated - info
response property
data/items/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_codedeprecated - info
response property
data/items/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_namedeprecated - info
response property
data/items/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_namedeprecated - info
response property
data/items/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_namedeprecated - info
response property
data/items/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_codedeprecated - info
response property
data/items/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_namedeprecated
- info
- breaking
the response property
//////became nullable for the status - breaking
the response property
//////became nullable for the status - breaking
the response property
//////became nullable for the status
- breaking