Sign in

v1

latestOpenAPI 3.1.02026-07-221206394.4 KB
Companies

Create a company

Creates a company. Only canonicalName is required.

post/v1/companies

Request body

canonicalNamestring required

The company's primary name.

alternativeNamesstring[]
websitestring
descriptionstring
shortDescriptionstring
sectorstring
industrystring
companyType'operating' | 'investor' | 'lender' | 'investment_bank' | 'advisor' | 'sponsor' | 'service_provider'
externalIdstring

Your own identifier for reconciling with external systems.

tagsstring[]
customobject

Example request

{
  "canonicalName": "Northwind Components",
  "website": "https://northwind.example"
}

Response

A company.

Example response

{
  "data": {
    "id": "665f1c2a9b1e4a0012a3b4c5",
    "canonicalName": "Acme Industrials",
    "website": "https://acme.example",
    "sector": "Industrials",
    "companyType": "operating",
    "employeeCount": 450,
    "ownershipStatus": "private",
    "enrichment": {
      "subsector": [
        {
          "value": "Self-Funded Health Insurance / Third Party Administrator (TPA)",
          "source": "CIM",
          "confidence": 100,
          "pinned": true,
          "discoveredAt": "2026-02-14T10:00:00Z"
        },
        {
          "value": "Third-Party Administrators (TPAs)",
          "source": "Market Report",
          "confidence": 57,
          "pinned": false,
          "discoveredAt": "2026-01-20T10:00:00Z"
        }
      ]
    }
  }
}