LEleadfeeder
Companies
v1

Match Companies

Changed on

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

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/companies/match
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
      Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: companies:read

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": [
    {
      "city": "Karlsruhe",
      "company_name": "Dealfront Group GmbH",
      "country": "Germany",
      "country_code": "DE",
      "email": "info@leadfeeder.com",
      "phone": "+49 721 50057501",
      "postal_code": "76131",
      "register_id": "HRB711540",
      "register_location": "Mannheim",
      "street": "Durlacher Allee 73",
      "street_name": "Durlacher Allee",
      "street_number": "73",
      "url": "https://www.leadfeeder.com/welcome",
      "vat_id": "DE276265194"
    }
  ]
}

Response

Success

Example response

{
  "data": [
    [
      {
        "attributes": {
          "match_score": 0.95
        },
        "relationships": {
          "company_summary": {
            "attributes": {
              "address": {
                "city": "Karlsruhe",
                "country": "Germany",
                "country_code": "DE"
              },
              "employee_range": "101-500",
              "industries": {
                "industry": [
                  {
                    "code": "1594.6.4",
                    "name": "Software Development"
                  }
                ]
              },
              "logo_url": "https://app.dealfront.com/logos/200/694ad7b1-lf-logo-2026-04-16.jpg",
              "meta": {
                "has_financials_earnings": true,
                "has_financials_net_worth": true,
                "has_financials_revenue": true,
                "has_ip_addresses": true,
                "has_mail": true,
                "has_phones": true,
                "has_register_id": true,
                "has_social_accounts": true,
                "has_vat_id": true
              },
              "name": "Dealfront Group GmbH",
              "register": {
                "status": "active"
              },
              "revenue": {
                "currency": "EUR",
                "value": 9694333,
                "value_eur": 9694333,
                "year": 2020
              },
              "role": "group_member",
              "url": "https://www.leadfeeder.com/welcome"
            },
            "id": "129011",
            "relationships": {
              "group_company": {
                "id": "129011"
              }
            },
            "type": "company_summary"
          }
        },
        "type": "company_match"
      }
    ]
  ],
  "meta": {
    "credits": {
      "charged": 1
    },
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

  • 1a2c2b1d560fRevision changes
    • breaking

      the response property ///////// became nullable for the status

  • ac752c6c2be0Revision 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