Companies
v1
Match Companies
Find matching companies based on the provided input parameters. Returns matching company IDs and basic company information. Important: Each company object must include at least one of these required fields: company_name, url, vat_id, or register_id. Additional fields like email, phone, and address can improve match accuracy but cannot be used alone. Credit Note: Matches do not consume credits. Credits are only used if you subsequently retrieve deep data for a company you haven't accessed within the last 12 months.
:::info Requires the companies:read OAuth2 scope. :::
post/v1/companies/match
Query parameters
account_idstring required
The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
max_results_per_companynumber
Number of maximum results per company match input object
Request body
Example request
{
"companies": [
{
"company_name": "Dealfront Group GmbH",
"url": "https://www.leadfeeder.com/welcome",
"email": "info@leadfeeder.com",
"phone": "+49 721 50057501",
"country": "Germany",
"country_code": "DE",
"city": "Karlsruhe",
"postal_code": "76131",
"street": "Durlacher Allee 73",
"street_name": "Durlacher Allee",
"street_number": "73",
"register_id": "HRB711540",
"register_location": "Mannheim",
"vat_id": "DE276265194"
}
]
}Response
Success
Example response
{
"data": [
[
{
"type": "company_match",
"attributes": {
"match_score": 0.95
},
"relationships": {
"company_summary": {
"type": "company_summary",
"id": "129011",
"attributes": {
"name": "Dealfront Group GmbH",
"url": "https://www.leadfeeder.com/welcome",
"address": {
"city": "Karlsruhe",
"country": "Germany",
"country_code": "DE"
},
"industries": {
"industry": [
{
"name": "Software Development",
"code": "1594.6.4"
}
]
},
"employee_range": "101-500",
"revenue": {
"currency": "EUR",
"year": 2020,
"value": 9694333,
"value_eur": 9694333
},
"role": "group_member",
"register": {
"status": "active"
},
"meta": {
"has_phones": true,
"has_mail": true,
"has_social_accounts": true,
"has_register_id": true,
"has_vat_id": true,
"has_financials_revenue": true,
"has_financials_earnings": true,
"has_financials_net_worth": true,
"has_ip_addresses": true
}
},
"relationships": {
"group_company": {
"id": "129011"
}
}
}
}
}
]
],
"meta": {
"credits": {
"charged": 1
},
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}