Match Companies
POST
/v1/companies/match
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.
Request
Query Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.leadfeeder.com/v1/companies/match?account_id=123456&max_results_per_company=5' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"companies": [
{
"company_name": "Dealfront Group GmbH",
"url": "https://www.dealfront.com/welcome",
"email": "info@dealfront.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 Response Example
200 - success
{
"data": [
[
{
"type": "company_match",
"id": "129011",
"attributes": {
"match_score": 0.95
},
"relationships": {
"company_summary": {
"id": "129011",
"type": "company_summary",
"attributes": {
"name": "Dealfront Group GmbH",
"role": "group_member",
"register": {
"status": "active"
},
"meta": {
"do_not_contact": false,
"has_updated_id": false,
"has_ip_addresses": true,
"has_phones": true,
"has_fax": false,
"has_mail": true,
"has_contacts": 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
}
},
"relationships": {
"group_company": {
"id": "159001425",
"type": "company"
}
}
}
}
},
{
"type": "company_match",
"id": "155950504",
"attributes": {
"match_score": 0.8
},
"relationships": {
"company_summary": {
"id": "155950504",
"type": "company_summary",
"attributes": {
"name": "Leaxxxxxxx",
"role": "group_member",
"register": {
"status": "active"
},
"meta": {
"do_not_contact": true,
"has_updated_id": false,
"has_ip_addresses": false,
"has_phones": true,
"has_fax": true,
"has_mail": true,
"has_contacts": false,
"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
}
},
"relationships": {
"group_company": null
}
}
}
}
]
],
"meta": {
"credits": {
"charged": 0
},
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}Modified at 2026-04-14 13:35:01