Private v1ApiPrivateV1LookupTransactions
Discoverable filter fields + aggregate methodology
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/transactions"{ "data": { "filters": [ { "field": "id", "type": "array_uuid", "operators": [ "in" ] }, { "field": "target_id", "type": "array_uuid", "operators": [ "in" ] }, { "field": "investor_id", "type": "array_uuid", "operators": [ "in" ], "description": "Companies that participated as a lead investor or buyer." }, { "field": "deal_type", "type": "array_string", "operators": [ "in" ], "values": [ "Early", "Growth", "M&A", "Public listing", "Secondary", "Venture" ] }, { "field": "deal_subtype", "type": "array_string", "operators": [ "in" ], "values": [ "Angel", "ICO", "PE buyout", "Pre-seed", "Secondary - private", "Secondary - public", "Seed", "Series A", "Series B", "Series C", "Series D", "Series E", "Series F", "Series G", "Series H", "Series I", "Series J", "Strategic M&A", "Strategic investment", "Undisclosed stage" ] }, { "field": "date_from", "type": "date", "operators": [ "gte" ] }, { "field": "date_to", "type": "date", "operators": [ "lte" ] }, { "field": "valuation_min", "type": "number", "operators": [ "gte" ], "description": "Millions USD." }, { "field": "valuation_max", "type": "number", "operators": [ "lte" ] }, { "field": "raised_min", "type": "number", "operators": [ "gte" ] }, { "field": "raised_max", "type": "number", "operators": [ "lte" ] }, { "field": "revenue_min", "type": "number", "operators": [ "gte" ] }, { "field": "revenue_max", "type": "number", "operators": [ "lte" ] }, { "field": "ebitda_min", "type": "number", "operators": [ "gte" ] }, { "field": "ebitda_max", "type": "number", "operators": [ "lte" ] }, { "field": "ev_revenue_min", "type": "number", "operators": [ "gte" ] }, { "field": "ev_revenue_max", "type": "number", "operators": [ "lte" ] }, { "field": "ev_ebitda_min", "type": "number", "operators": [ "gte" ] }, { "field": "ev_ebitda_max", "type": "number", "operators": [ "lte" ] }, { "field": "target_country", "type": "array_string", "operators": [ "in" ] }, { "field": "target_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": "target_verticals", "type": "array_string", "operators": [ "overlaps" ] }, { "field": "target_themes", "type": "array_string", "operators": [ "overlaps" ] }, { "field": "target_client_focus", "type": "array_string", "operators": [ "overlaps" ] }, { "field": "target_revenue_model", "type": "array_string", "operators": [ "overlaps" ] }, { "field": "target_company_type", "type": "array_string", "operators": [ "overlaps" ] }, { "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": [ "deal_date", "deal_valuation", "deal_raised", "updated_at" ], "sub_resources": [], "aggregate": { "metrics": [ "ev_revenue", "ev_ebitda", "valuation", "raised", "revenue", "ebitda" ], "time_buckets": [ "month", "quarter", "year", "none" ], "methodology": { "small_n_threshold": 5, "outlier_rule": "iqr_1.5", "default_date_range_years": 5, "empty_buckets_returned": true } } }}Discoverable filter fields, enums, sort keys GET
Previous Page
List / search deals (offset-paginated) POST
Each row has the target company plus participants: M&A deals populate `buyers`; funding rounds populate `lead_investors`. The full investor list (`investors`) is available on the single-deal endpoint `GET /transactions/{id}`.