---
title: "Match company by name"
method: GET
path: "/match"
---

# Match company by name

`GET /match`

Pairs a company name with business domain profiles. Returns potential matches ranked by relevance, with the most likely match listed first. Location and contact info improve matching accuracy.

## Query parameters

- `name` string, required — The company name to match
- `phone` string, nullable — Phone number to augment the search (E.164 or local format)
- `city` string, nullable — City to augment the search
- `state` string, nullable — State code to augment the search
- `country` string, nullable — ISO-3166-1 alpha-2 country code to augment the search
- `zip_code` string, nullable — Zip code to augment the search
- `strict` boolean — Enable strict matching (no filter relaxation)
- `local_mode` boolean — Preserve location filters during relaxation.
- `min_match_confidence` integer — Minimum match_confidence (inclusive, 50-100) a match must have to be returned. Defaults to 50, the standard quality floor.

## Response `200`

Successful Response

- MatchResponse — Response from the /match endpoint.
  - `query` MatchQuery, required — Query parameters echoed back in match response, excluding omitted fields.
    - `name` string, required — The company name that was searched
    - `country` string, nullable — Country code filter used (ISO-3166-1 alpha-2)
    - `state` string, nullable — State code filter used
    - `city` string, nullable — City filter used
    - `zip` string, nullable — Zip code filter used
    - `phones` string, nullable — Phone number filter used
  - `matches` MatchResult[], required — Array of BizData profiles with match_confidence, ranked by relevance
    - `domain` string, nullable — Matched company domain, or None if no match was found
    - `name` string, nullable — Latest and most accurate company name from certificate or website
    - `status` CompanyStatus — Company operating status with confidence score.
      - `status` string, nullable — Operating status: 'active' or 'closed'
      - `confidence` number, nullable — Confidence score for the status (0.0-1.0)
    - `score` integer, nullable — Company size and buying power computed from certificates history (1-800)
    - `start_date` string, nullable — Company start date, derived from the date of the first certificate (YYYY-MM-DD)
    - `end_date` string, nullable — Company end date if closed (YYYY-MM-DD), empty if still in business
    - `address` CompanyAddress — Company headquarters address from website metatags or content.
      - `street` string, nullable — Street address of HQ, from website metatags or content
      - `city` string, nullable — City, from website metatags or content
      - `state` string, nullable — State code, from website metatags or content
      - `zip` string, nullable — ZIP/postal code, from website metatags or content
      - `country` string, nullable — Two-letter country code (ISO 3166-1 alpha-2), from website metatags or content
    - `phones` string[], nullable — Array of phone numbers listed on the website
    - `public_emails` string[], nullable — Array of contact emails listed on the website
    - `domain_associations` string[] — Associated domains
    - `social_urls` string[], nullable — URLs pointing to the company page on Twitter, LinkedIn, Facebook
    - `redirect_domain` string, nullable — Last domain in the redirect chain, if any
    - `description` string, nullable — Description, from website metatags or content
    - `keywords` object — Keywords generated by Natural Language Models based on site content, as keyword:confidence pairs
    - `industry_groups` object — Top industries (up to 2), as industry:confidence pairs
    - `employees` string, nullable — Employee count range: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
    - `revenue_range` '<1M' | '1-10M' | '10-100M' | '100M-1B' | '>1B' | 'N/A', nullable — Company revenue bucket: <1M, 1-10M, 10-100M, 100M-1B, >1B, or N/A when unknown
    - `business_model` object — Business model labels as label:confidence pairs (B2B, B2C, B2G, G2B, G2C, D2C, C2C, C2B)
    - `update_date` string, nullable — Date of last record update (YYYY-MM-DD)
    - `mx_provider` string, nullable — Email/MX hosting provider for the domain: a provider domain (e.g. 'google.com', 'microsoft.com'), the sentinel 'no_mx' when the domain was checked and has no mail server, or null when not resolved
    - `linkup` unknown
    - `match_confidence` number, nullable — Match confidence level 0-100, where 100 indicates a perfect match

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/discolike/apis/discolike-api.md) · [All operations](https://skmtc.net/discolike/apis/discolike-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/discolike/discolike-api/versions/3248fc62024c/schema)