Companies

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",
              "logo_url": "https://app.dealfront.com/logos/200/694ad7b1-lf-logo-2026-04-16.jpg",
              "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"
  }
}

Changes

Changed in 3 of the 18 revisions of this API.16

Sep 2, 20267a571092a3081See the full diff
- ▲
  the response property ///////// became nullable for the status
  response-property-became-nullable
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 4, 2026e036d9337a941See the full diff
- ○
  added the required property ////// to the response with the status
  response-required-property-added
Jul 26, 20267f61434b15da5See the full diff
- ○
  added the required property ////// to the response with the status
  response-required-property-added
- ○
  added the required property ////// to the response with the status
  response-required-property-added
- ○
  added the required property ////// to the response with the status
  response-required-property-added
- ○
  added the required property ////// to the response with the status
  response-required-property-added
- ○
  added the required property ////// to the response with the status
  response-required-property-added

Of the 18 revisions, 1 has no diff computed.

Full history