Resolve Company Names

Introduction

Resolve a batch of free-text company names to Multiples company IDs in a single call. Each input name is matched case-insensitively against company names and returns either an exact ID, a ranked list of candidates when the name is ambiguous, or no match. Use this endpoint to map names from your own spreadsheets or systems onto Multiples IDs before calling the per-company endpoints (such as /companies/{id}/fundings or /companies/{id}/acquisitions).

Set up

Endpoint

POST https://multiples.vc/api/private/v1/companies/resolve

Request

Send a JSON body with a non-empty names array (max 200 entries). Each entry must be a non-empty string.

{
  "names": [
    "Salesforce",
    "Microsof",
    "Zzqx Nonexistent Co"
  ]
}

field	type	description
`names`	string[]	Required. List of company names to resolve. Maximum 200 names per call; each must be a non-empty string.

Response

The response returns one match object per input name, in the same order. The candidates array is present only when match_type is ambiguous.

{
  "data": [
    {
      "query": "Salesforce",
      "id": "6f331dee-e4e5-478c-89cd-1aedf66f9515",
      "match_type": "exact"
    },
    {
      "query": "Microsof",
      "id": null,
      "match_type": "ambiguous",
      "candidates": [
        {
          "id": "2ad87f8c-ac55-4e3c-bdd6-ac1a5e50f8a9",
          "name": "Microsoft",
          "country": "USA",
          "score": 0.89
        },
        {
          "id": "6e9b34f8-3a73-4246-9a19-01cfd3402215",
          "name": "Microsoft Accelerator",
          "country": "USA",
          "score": 0.38
        },
        {
          "id": "93fe7742-c1a5-4d71-bd9b-a812f094eced",
          "name": "Microsoft for Startups",
          "country": "USA",
          "score": 0.36
        }
      ]
    },
    {
      "query": "Zzqx Nonexistent Co",
      "id": null,
      "match_type": "no_match"
    }
  ]
}

Fields

Each element of data is a match object:

field	type	description
`query`	string	The input name this result corresponds to.
`id`	string \| null	The resolved company ID (UUID). Populated when `match_type` is `exact`; `null` otherwise.
`match_type`	string	One of `exact` (a single confident name/short_name match), `ambiguous` (no single exact match - one or more fuzzy/substring candidates were found; see `candidates`, which may hold just one), or `no_match` (nothing found).
`candidates`	object[]	Ranked list of fuzzy candidate matches (1-5, by score). Populated only when `match_type` is `ambiguous`.

Each entry in candidates:

field	type	description
`id`	string	Company ID (UUID) of the candidate.
`name`	string \| null	Candidate company name. May be `null` when no display name is populated.
`country`	string \| null	ISO 3166-1 alpha-3 country code (e.g. `USA`, `CAN`, `IND`).
`score`	number	Fuzzy match score between 0 and 1, where 1 is the closest match. Candidates are sorted by descending score.

Company Investors

List of Investors