Skip to main content
GET
/
v1
/
companies
List companies
curl --request GET \
  --url https://api.metal.ai/v1/companies \
  --header 'x-metal-api-key: <api-key>' \
  --header 'x-metal-client-id: <api-key>'
{
  "data": [
    {
      "id": "665f1c2a9b1e4a0012a3b4c5",
      "canonicalName": "Acme Industrials",
      "alternativeNames": [
        "<string>"
      ],
      "website": "https://acme.example",
      "description": "<string>",
      "shortDescription": "<string>",
      "sector": "Industrials",
      "subsector": "<string>",
      "industry": "<string>",
      "location": {
        "city": "<string>",
        "state": "<string>",
        "country": "<string>"
      },
      "companyType": "operating",
      "externalId": "<string>",
      "externalReference": {
        "source": "<string>",
        "id": "<string>"
      },
      "tags": [
        "<string>"
      ],
      "assignees": [
        {
          "id": "<string>",
          "type": "<string>"
        }
      ],
      "custom": {},
      "employeeCount": 450,
      "ownershipStatus": "private",
      "lastValuation": 123,
      "lastRoundDate": "2023-12-25",
      "lastAmountRaised": 123,
      "totalMoneyRaised": 123,
      "lastFinancials": {},
      "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"
          }
        ]
      },
      "lastEnrichedAt": "2023-11-07T05:31:56Z",
      "lastEnrichmentStartedAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

x-metal-client-id
string
header
required

The Client ID of your API key.

x-metal-api-key
string
header
required

The secret value of your API key.

Query Parameters

page
integer
default:1

Page number, starting at 1 (max 100).

Required range: 1 <= x <= 100
limit
integer
default:100

Items per page (1–1000).

Required range: 1 <= x <= 1000
lt
string

Cursor: return items whose id is less than this value (use the last id from the previous page).

sort
string

Field to sort by. Defaults to id.

direction
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc

Response

A list of companies.

data
object[]