Private v1ApiPrivateV1LookupCompanies
Discoverable filter fields, enums, sort keys
Authorization
bearerAuth AuthorizationBearer <token>
Send your API key as a bearer token in the Authorization header:
Authorization: Bearer mpl_live_.... A single key grants access to
all endpoints in this API. Contact your account manager to obtain or
rotate a key.
In: header
Response Body
application/json
curl -X GET "https://example.com/api/private/v1/lookup/companies"{ "data": { "filters": [ { "field": "id", "type": "array_uuid", "operators": [ "in" ], "description": "Batch lookup of company UUIDs." }, { "field": "name", "type": "string", "operators": [ "ilike", "eq" ], "description": "Case-insensitive substring match on the company name." }, { "field": "country", "type": "array_string", "operators": [ "in" ], "description": "ISO-3 country codes (e.g. USA, GBR, DEU)." }, { "field": "region", "type": "array_string", "operators": [ "in" ], "values": [ "Africa", "Central Asia", "East Asia", "Eastern Europe", "Latin America", "Middle East", "North America", "Northern Europe", "Oceania", "South Asia", "South-East Asia", "Southern Europe", "Western Europe" ] }, { "field": "verticals", "type": "array_string", "operators": [ "overlaps" ] }, { "field": "themes", "type": "array_string", "operators": [ "overlaps" ] }, { "field": "client_focus", "type": "array_string", "operators": [ "overlaps" ] }, { "field": "revenue_model", "type": "array_string", "operators": [ "overlaps" ] }, { "field": "company_type", "type": "array_string", "operators": [ "overlaps" ] }, { "field": "ownership", "type": "string", "operators": [ "eq" ], "description": "Exact match on ownership label (e.g. 'Publicly listed', 'Privately held')." }, { "field": "active", "type": "boolean", "operators": [ "eq" ] }, { "field": "founded_min", "type": "number", "operators": [ "gte" ], "description": "Founding-year lower bound." }, { "field": "founded_max", "type": "number", "operators": [ "lte" ] }, { "field": "ipoed_from", "type": "date", "operators": [ "gte" ] }, { "field": "ipoed_to", "type": "date", "operators": [ "lte" ] }, { "field": "updated_at", "type": "datetime", "operators": [ "gte" ], "description": "Change-feed checkpoint." }, { "field": "include_deleted", "type": "boolean", "operators": [ "eq" ], "description": "Default false. Set true on change-feed pulls." } ], "sort_fields": [ "name", "founded", "ipoed", "updated_at" ], "sub_resources": [ "/companies/{id}/fundings", "/companies/{id}/sellside", "/companies/{id}/buyside", "/companies/{id}/investors" ] }}