{ "openapi": "3.1.0", "info": { "title": "FundingData API", "version": "1.4.0", "description": "Startup funding rounds, investors, funds and M&A. Every record links its source (citation.url): the published article, or for older records the tech.eu deal-database entry. amountUSD null = undisclosed. Plan quotas: records per month through the API, MCP and CSV (429 monthly_quota when used up; X-Quota-* headers on every metered response; /v1/usage for the meter). Unknown query parameters are ignored — compare the echoed args object in list responses with what you sent. MCP: POST /mcp (JSON-RPC 2.0, same credentials). Rounds carry amountEUR (ECB rate on the round date) next to amountUSD. tech.eu deal-database rows whose source states no stage carry stageEstimated:true. Customer plans must credit FundingData (X-Attribution header).", "license": { "name": "FundingData Terms of Service", "url": "https://fundingdata.com/terms" }, "termsOfService": "https://fundingdata.com/terms", "contact": { "url": "https://fundingdata.com/pricing", "email": "contact@fundingdata.com" } }, "servers": [ { "url": "https://fundingdata.com" } ], "security": [ { "apiKey": [] }, { "bearer": [] } ], "components": { "securitySchemes": { "apiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key" }, "bearer": { "type": "http", "scheme": "bearer", "description": "Authorization: Bearer fdk_…" } }, "schemas": { "Round": { "type": "object", "description": "One funding round. Amounts are in USD at the ECB reference rate of the round date, or of the previous ECB business day when the round date has none (fxRate/fxDate); the native figure is kept in amountNative/currency. null amountUSD = undisclosed, never summed.", "properties": { "id": { "type": "string", "description": "Stable record id (iNNNNNN). Merged duplicates keep the surviving id; see /v1/rounds/changes." }, "companyId": { "type": [ "string", "null" ], "description": "Company entity id (present on /v1/company rounds)" }, "company": { "type": "string" }, "date": { "type": "string", "format": "date", "description": "Announcement date. Before 2016 often month precision (day = last of month)." }, "quarter": { "type": "string", "description": "YYYY-Qn" }, "stage": { "type": [ "string", "null" ], "description": "Normalised stage. null on customer plans when the source states no stage (see stageEstimated); partner/internal keys get the stored value unless stages=honest", "enum": [ "Pre-Seed", "Seed", "Series A", "Series B", "Series C", "Series D", "Series E", "Series F", "Growth", null ] }, "stageRaw": { "type": [ "string", "null" ], "description": "Stage wording as the source had it (null when the source gave none)" }, "stageEstimated": { "type": "boolean", "description": "tech.eu deal-database rows only: true when the source category is not a stage (\"Other\", \"funding round\", debt, grant, …) and the stage was bucketed from the round size on import (<$6M Seed, <$20M Series A, <$60M Series B, <$150M Series C, else Growth). The app shows these as \"Undisclosed\"." }, "stageEstimate": { "type": [ "string", "null" ], "description": "The size bucket, when stage was nulled because stageEstimated is true" }, "amountUSD": { "type": [ "number", "null" ], "description": "null = undisclosed (never summed)" }, "amountNative": { "type": [ "number", "null" ], "description": "Amount in the announcement currency" }, "currency": { "type": [ "string", "null" ], "description": "ISO-4217 code of amountNative" }, "fxRate": { "type": [ "number", "null" ], "description": "Native→USD rate applied (1 for USD)" }, "fxDate": { "type": [ "string", "null" ], "description": "Day of the ECB rate in fxRate: the round date, or the latest ECB business day before it (weekends, TARGET holidays)", "format": "date" }, "amountEUR": { "type": [ "number", "null" ], "description": "Amount in EUR at the ECB reference rate on the round date (EUR-native rounds: the native figure). Absent when amountUSD is null or the round predates 2011-12-30" }, "eurRate": { "type": [ "number", "null" ], "description": "USD per EUR used for amountEUR (ECB reference rate)" }, "eurRateDate": { "type": [ "string", "null" ], "description": "Date of the EUR rate (latest ECB business day on or before the round date)", "format": "date" }, "valuationUSD": { "type": [ "number", "null" ] }, "instrument": { "type": "string", "description": "equity | debt | grant | secondary", "enum": [ "equity", "debt", "grant", "secondary" ] }, "roundType": { "type": "string", "description": "sized (amount disclosed) | announced (amount undisclosed)", "enum": [ "sized", "announced" ] }, "scope": { "type": [ "string", "null" ], "description": "Issuer class when known: startup | public | corporate | infrastructure | government | fund. null = not yet classified (instrument=venture filters to startup equity)." }, "sector": { "type": [ "string", "null" ] }, "geo": { "type": [ "string", "null" ], "description": "HQ ISO-3166 alpha-2" }, "country": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "investors": { "type": "array", "items": { "type": "string" }, "description": "Investors as the cited source names them (not merged across sources)" }, "leadInvestors": { "type": [ "array", "null" ], "description": "Investors the source explicitly calls lead", "items": { "type": "string" } }, "founders": { "type": [ "array", "null" ], "items": { "type": "string" } }, "founderOrigins": { "type": [ "array", "null" ], "description": "ISO-3166 alpha-2 founder origin countries where reported", "items": { "type": "string" } }, "marketReasons": { "type": "array", "items": { "type": "string", "enum": [ "hq", "founder", "investor" ] }, "description": "Present only when the request has market=: why this round is in that market (hq = HQ country, founder = founder origin, investor = an investor headquartered there)" }, "confidence": { "type": "number", "description": "Extractor confidence 0..1" }, "provenance": { "type": "string", "description": "auto (extracted from the cited source) | manual (entered or corrected by hand)", "enum": [ "auto", "manual" ] }, "citation": { "$ref": "#/components/schemas/Citation" }, "sources": { "type": "array", "items": { "$ref": "#/components/schemas/Citation" }, "description": "Additional citations when more than one outlet reported the round" } }, "required": [ "id", "company", "date", "citation" ] }, "Citation": { "type": "object", "description": "The published source a figure is taken from. For records before 2016 this is often the tech.eu deal-database entry rather than an article.", "properties": { "url": { "type": "string", "format": "uri" }, "title": { "type": [ "string", "null" ] }, "publisher": { "type": [ "string", "null" ] } }, "required": [ "url" ] }, "ChangeRow": { "type": "object", "description": "Incremental-sync row (snake_case, straight from the sync view). status=live rows are current. When the response envelope says tombstones:true, an incremental page (since given) also carries rows that LEFT the live set, flagged tombstone:true — status=dup (merged into another id: keep the winner), review (parked) or rumor (re-classified) — delete them from a mirror. tombstones:false = live rows only (a vanished id is then the only signal). The initial full sync (no since) is always live-only.", "properties": { "id": { "type": "string" }, "company_id": { "type": [ "string", "null" ] }, "company": { "type": "string" }, "date": { "type": "string", "format": "date" }, "stage": { "type": [ "string", "null" ] }, "stage_raw": { "type": [ "string", "null" ] }, "amount_usd": { "type": [ "number", "null" ] }, "amount_native": { "type": [ "number", "null" ] }, "currency": { "type": [ "string", "null" ] }, "valuation_usd": { "type": [ "number", "null" ] }, "instrument": { "type": "string" }, "scope": { "type": [ "string", "null" ] }, "sector": { "type": [ "string", "null" ] }, "geo": { "type": [ "string", "null" ] }, "hq_city": { "type": [ "string", "null" ] }, "investors": { "type": "array", "items": { "type": "string" } }, "lead_investors": { "type": [ "array", "null" ], "items": { "type": "string" } }, "confidence": { "type": "number" }, "source": { "type": [ "object", "null" ] }, "source_url": { "type": [ "string", "null" ] }, "status": { "type": "string", "description": "live | dup | review | rumor" }, "tombstone": { "type": "boolean", "description": "true when status is not live (incremental pages only)" }, "updated_at": { "type": "string", "format": "date-time" }, "stageEstimated": { "type": "boolean", "description": "true = tech.eu deal-database row whose source states no stage; stage holds the size bucket (unchanged here for every plan — a mirror keeps its non-null stage)" }, "stageEstimate": { "type": [ "string", "null" ], "description": "The size bucket when stageEstimated, else null" }, "amountEUR": { "type": [ "number", "null" ], "description": "amount_usd in EUR at the ECB reference rate of eurRateDate (EUR-native rows: amount_native). null without an amount or before 2011-12-30" }, "eurRate": { "type": [ "number", "null" ], "description": "USD per EUR used for amountEUR" }, "eurRateDate": { "type": [ "string", "null" ], "description": "Day of that ECB rate: the latest business day on or before the row's FX day", "format": "date" } }, "required": [ "id", "company", "date", "status", "updated_at" ] }, "Cursor": { "type": [ "object", "null" ], "description": "null when the page was the last one", "properties": { "since": { "type": "string" }, "afterId": { "type": "string" } } }, "Usage": { "type": "object", "properties": { "plan": { "type": "string" }, "planLabel": { "type": "string" }, "metered": { "type": "boolean", "description": "false for internal / partner keys and for member sessions on routes that are not metered" }, "key": { "type": [ "string", "null" ], "description": "API key name when the call carried a key" }, "month": { "type": "string", "description": "YYYY-MM (UTC)" }, "monthlyRecords": { "type": [ "integer", "null" ], "description": "Plan quota (null = unlimited)" }, "used": { "type": "integer" }, "remaining": { "type": [ "integer", "null" ] }, "resetsAt": { "type": "string", "format": "date-time" }, "limits": { "type": "object", "properties": { "historyDays": { "type": [ "integer", "null" ] }, "maxRows": { "type": [ "integer", "null" ] }, "maxDepth": { "type": [ "integer", "null" ] }, "export": { "type": "boolean" }, "bulk": { "type": "boolean" }, "aiDaily": { "type": [ "integer", "null" ], "description": "AI answers per UTC day (0 = not on this plan, null = no cap)" }, "attribution": { "type": "boolean", "description": "Data must credit FundingData (responses carry X-Attribution)" } } }, "info": { "type": "string" } } }, "PlanLimit": { "type": "object", "description": "Present when paging stopped at the plan's depth (maxDepth: free 250, Pro 1,000, API 10,000 results per search) — narrow the filter instead of paging further", "properties": { "maxDepth": { "type": "integer" }, "plan": { "type": "string" }, "upgrade": { "type": "string" } } }, "Error": { "type": "object", "properties": { "error": { "type": "string" }, "info": { "type": "string" }, "allowed": { "type": "array", "items": { "type": "string" }, "description": "For 400s on enum parameters: the accepted values" } }, "required": [ "error" ] }, "QuotaError": { "type": "object", "description": "monthly_quota (plan records for the month used up; resets on the 1st UTC), daily rate limit exceeded (per-key daily cap; resets 00:00 UTC), or the per-IP burst limit. The Retry-After header carries the seconds to wait.", "properties": { "error": { "type": "string" }, "info": { "type": "string" }, "plan": { "type": "string" }, "monthlyRecords": { "type": "integer" }, "upgrade": { "type": "string", "format": "uri" }, "retryAfter": { "type": "integer", "description": "Seconds until the quota resets" } }, "required": [ "error" ] } }, "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } } }, "paths": { "/v1/rounds": { "get": { "operationId": "listRounds", "summary": "List funding rounds (newest first)", "parameters": [ { "name": "sector", "in": "query", "required": false, "schema": { "type": "string", "description": "Sector label (enum at /v1/facets)" } }, { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "description": "Stage. Undisclosed = tech.eu deal-database rows whose source states no stage (stageEstimated). On customer plans a stage filter leaves those rows out and /v1/stats byStage counts them under Undisclosed; partner/internal keys match the stored stage unless stages=honest", "enum": [ "Pre-Seed", "Seed", "Series A", "Series B", "Series C", "Series D", "Series E", "Series F", "Growth", "Undisclosed" ] } }, { "name": "includeEstimated", "in": "query", "required": false, "schema": { "type": "boolean", "description": "true: on customer plans the stage filter also matches size-estimated stages (stageEstimated rows) and byStage counts them under their estimate" } }, { "name": "geo", "in": "query", "required": false, "schema": { "type": "string", "description": "Region (Türkiye, Europe, MENA, Americas, Asia, Africa) or HQ ISO-3166 alpha-2 country code. A code the data does not carry is a 400 naming /v1/facets (countries[].code lists the valid codes)" } }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string", "description": "HQ country, ISO-3166 alpha-2 (alternative to geo; same 400 rule)" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region name (alternative to geo)" } }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "description": "YYYY, YYYY-Qn or YYYY-Hn. Anything else is ignored (no filter) — check args in the response." } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "integer", "description": "First year (alternative to period)" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "integer", "description": "Last year (alternative to period)" } }, { "name": "dateFrom", "in": "query", "required": false, "schema": { "type": "string", "description": "First round date, strict YYYY-MM-DD (other formats are ignored)", "format": "date" } }, { "name": "dateTo", "in": "query", "required": false, "schema": { "type": "string", "description": "Last round date, strict YYYY-MM-DD", "format": "date" } }, { "name": "investor", "in": "query", "required": false, "schema": { "type": "string", "description": "Investor name (whole-name match, case-insensitive; aliases resolved, e.g. a16z → Andreessen Horowitz)" } }, { "name": "minAmountUSD", "in": "query", "required": false, "schema": { "type": "number", "description": "Minimum disclosed round size, USD" } }, { "name": "instrument", "in": "query", "required": false, "schema": { "type": "string", "description": "equity | debt | grant | secondary | venture (= equity rounds by startups: excludes public companies, corporates, infrastructure, government and funds)", "enum": [ "equity", "debt", "grant", "secondary", "venture" ] } }, { "name": "founderOrigin", "in": "query", "required": false, "schema": { "type": "string", "description": "Founder origin country, ISO-3166 alpha-2 (where the cited reporting names it)" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string", "description": "Market, ISO-3166 alpha-2: rounds whose HQ is the country, OR whose founders are from it (founderOrigin rule), OR with at least one investor headquartered there. Each returned round then carries marketReasons. A malformed code is a 400", "pattern": "^[A-Za-z]{2}$" } }, { "name": "investorCountry", "in": "query", "required": false, "schema": { "type": "string", "description": "ISO-3166 alpha-2: rounds with at least one investor headquartered in the country (investor HQ from a curated list, GLEIF, or a ≥70% portfolio majority). A malformed code is a 400", "pattern": "^[A-Za-z]{2}$" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "description": "Free text over company, sector and investor names (≥2 chars)" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "description": "Order (default: newest first)", "enum": [ "amount_desc", "amount_asc", "valuation_desc", "date_asc" ] } }, { "name": "stages", "in": "query", "required": false, "schema": { "type": "string", "description": "honest = stage null + stageEstimate on size-bucketed rows; stored = the stored stage (default for partner keys). Customer plans default to honest.", "enum": [ "honest", "stored" ] } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated list of row fields to return (id is always kept) — compact rows for agents, e.g. fields=company,date,stage,amountUSD,citation" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Rows per page (max 500)", "maximum": 500, "default": 100 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging offset (stops at the plan depth; see planLimit)" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "rows": { "type": "array", "items": { "$ref": "#/components/schemas/Round" } }, "total": { "type": "integer", "description": "Matching rows (before plan depth)" }, "planLimit": { "$ref": "#/components/schemas/PlanLimit" }, "totalUSD": { "type": "number", "description": "Sum of disclosed amounts in the match (undisclosed rounds excluded)" }, "companies": { "type": "integer" }, "investors": { "type": "integer" }, "args": { "type": "object", "description": "The filters the server actually applied — an unknown or malformed filter is simply absent here" } }, "required": [ "rows" ] } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/rounds/changes": { "get": { "operationId": "syncRounds", "summary": "Incremental sync: live rounds created, updated or merged since a cursor, oldest first", "description": "Keyset-paged by (updated_at, id). Start with since= (or none for the full set); pass next.since + next.afterId back until next is null. With tombstones:true, rows whose status is not live are tombstones (dup = merged into another id, review = parked, rumor = re-classified): delete them from a mirror. API plan only.", "parameters": [ { "name": "since", "in": "query", "required": false, "schema": { "type": "string", "description": "ISO-8601 timestamp (inclusive)", "format": "date-time" } }, { "name": "afterId", "in": "query", "required": false, "schema": { "type": "string", "description": "id of the last row of the previous page (from next.afterId)" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Rows (max 1000)", "maximum": 1000, "default": 1000 } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "rows": { "type": "array", "items": { "$ref": "#/components/schemas/ChangeRow" } }, "tombstones": { "type": "boolean", "description": "true when this page can include tombstone rows (non-live statuses); false = live rows only" }, "next": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "rows", "next" ] } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/events/changes": { "get": { "operationId": "syncEvents", "summary": "Incremental sync for events (same cursor contract as /v1/rounds/changes)", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "description": "Event type, e.g. fund_close" } }, { "name": "since", "in": "query", "required": false, "schema": { "type": "string", "description": "ISO-8601 timestamp (inclusive)", "format": "date-time" } }, { "name": "afterId", "in": "query", "required": false, "schema": { "type": "string", "description": "id of the last row of the previous page (from next.afterId)" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Rows (max 1000)", "maximum": 1000, "default": 1000 } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "rows": { "type": "array", "items": { "type": "object", "description": "Event row (snake_case table columns) plus the additive amountEUR / eurRate / eurRateDate (1.4.0): the headline USD figure in data (amountUSD, priceUSD, fundSizeUSD or raiseUSD) in EUR at the ECB rate on or before the event date; null when the event has no amount", "properties": { "amountEUR": { "type": [ "number", "null" ] }, "eurRate": { "type": [ "number", "null" ] }, "eurRateDate": { "type": [ "string", "null" ], "format": "date" } } } }, "next": { "$ref": "#/components/schemas/Cursor" } }, "required": [ "rows", "next" ] } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/company": { "get": { "operationId": "getCompany", "summary": "One company: funding history with citations (by name or website domain)", "parameters": [ { "name": "name", "in": "query", "required": false, "schema": { "type": "string", "description": "Company name (exact first, then a unique whole-word match; 404 carries didYouMean suggestions — or call /v1/resolve first). Required unless domain is given." } }, { "name": "domain", "in": "query", "required": false, "schema": { "type": "string", "description": "Website domain instead of a name, e.g. mistral.ai — scheme, www., port and path are ignored (https://www.mistral.ai/about = mistral.ai); a subdomain also tries its parent. Matched against the websites stated in cited articles. Used when name is absent." } }, { "name": "stages", "in": "query", "required": false, "schema": { "type": "string", "description": "honest = stage null + stageEstimate on size-bucketed rows; stored = the stored stage (default for partner keys). Customer plans default to honest.", "enum": [ "honest", "stored" ] } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated list of row fields to return (id is always kept) — compact rows for agents, e.g. fields=company,date,stage,amountUSD,citation" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "company": { "type": "string" }, "country": { "type": [ "string", "null" ] }, "geo": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "sector": { "type": [ "string", "null" ] }, "founders": { "type": [ "array", "null" ], "items": { "type": "string" } }, "founderOrigins": { "type": [ "array", "null" ], "items": { "type": "string" } }, "totalRaisedUSD": { "type": "number" }, "equityRaisedUSD": { "type": "number" }, "raisedByInstrument": { "type": "object", "additionalProperties": { "type": "number" } }, "roundCount": { "type": "integer" }, "firstDate": { "type": [ "string", "null" ] }, "lastDate": { "type": [ "string", "null" ] }, "rounds": { "type": "array", "items": { "$ref": "#/components/schemas/Round" } }, "investors": { "type": "array", "items": { "type": "string" } }, "variants": { "type": "array", "items": { "type": "string" }, "description": "Other spellings merged into this company" }, "resolvedFrom": { "type": "object", "description": "domain= only: the domain asked for and the recorded website it matched", "properties": { "domain": { "type": "string" }, "matchedDomain": { "type": "string" } } }, "planLimit": { "$ref": "#/components/schemas/PlanLimit" } } } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found (didYouMean lists close names)", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "didYouMean": { "type": "array", "items": { "type": "string" } } } } } } }, "409": { "description": "domain= only: the domain is recorded for several companies, or for one company whose name it does not contain and that only one article states (e.g. a publisher's site) — candidates listed; call again with name=", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "domain": { "type": "string" }, "matchedDomain": { "type": "string" }, "candidates": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "domain": { "type": "string" }, "citations": { "type": "integer", "description": "Cited articles stating this website for the company" }, "rounds": { "type": "integer" }, "nameInDomain": { "type": "boolean" } } } } } } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/investor": { "get": { "operationId": "getInvestor", "summary": "One investor: deals, capital in joined rounds, portfolio (paged)", "parameters": [ { "name": "name", "in": "query", "required": true, "schema": { "type": "string", "description": "Investor name (case-insensitive; aliases resolved)" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Portfolio rows per page, newest first (max 300). Customer plans default to 50; partner/internal keys get the newest 300 unless limit or offset is sent", "maximum": 300 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Portfolio paging offset: pass portfolioPage.nextOffset" } }, { "name": "stages", "in": "query", "required": false, "schema": { "type": "string", "description": "honest = stage null + stageEstimate on size-bucketed rows; stored = the stored stage (default for partner keys). Customer plans default to honest.", "enum": [ "honest", "stored" ] } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated list of row fields to return (id is always kept) — compact rows for agents, e.g. fields=company,date,stage,amountUSD,citation" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "investor": { "type": "string" }, "dealCount": { "type": "integer", "description": "Every deal (the aggregates are never paged)" }, "companyCount": { "type": "integer" }, "deployedUSD": { "type": "number", "description": "Sum of the rounds the investor joined — capital PARTICIPATED in, not the investor's own cheque" }, "portfolio": { "type": "array", "items": { "$ref": "#/components/schemas/Round" }, "description": "This page of the portfolio, newest first" }, "portfolioShown": { "type": "integer" }, "portfolioTruncated": { "type": "boolean", "description": "More portfolio rows after this page" }, "portfolioPage": { "type": "object", "description": "Present when the portfolio is paged", "properties": { "offset": { "type": "integer" }, "limit": { "type": "integer" }, "total": { "type": "integer" }, "nextOffset": { "type": [ "integer", "null" ], "description": "null on the last page" } } }, "planLimit": { "$ref": "#/components/schemas/PlanLimit" } } } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found (didYouMean lists close names)", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "didYouMean": { "type": "array", "items": { "type": "string" } } } } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/companies": { "get": { "operationId": "listCompanies", "summary": "Company directory", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "description": "Name contains" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region" } }, { "name": "sector", "in": "query", "required": false, "schema": { "type": "string", "description": "Sector" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "description": "raised | rounds | recent | name", "enum": [ "raised", "rounds", "recent", "name" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Rows per page (max 1000)", "maximum": 1000, "default": 100 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging offset (stops at the plan depth; see planLimit)" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "rows": { "type": "array", "items": { "type": "object" } }, "total": { "type": "integer", "description": "Matching rows (before plan depth)" }, "planLimit": { "$ref": "#/components/schemas/PlanLimit" } }, "required": [ "rows" ] } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/investors": { "get": { "operationId": "listInvestors", "summary": "Investor directory", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "description": "Name contains" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "description": "deployed | deals | recent | name", "enum": [ "deployed", "deals", "recent", "name" ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Rows per page (max 1000)", "maximum": 1000, "default": 100 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging offset (stops at the plan depth; see planLimit)" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "rows": { "type": "array", "items": { "type": "object" } }, "total": { "type": "integer", "description": "Matching rows (before plan depth)" }, "planLimit": { "$ref": "#/components/schemas/PlanLimit" } }, "required": [ "rows" ] } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/search": { "get": { "operationId": "search", "summary": "Name search across companies, investors, sectors", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "description": "Query (≥2 chars)" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/stats": { "get": { "operationId": "getStats", "summary": "Aggregates for a filter set (not metered)", "parameters": [ { "name": "sector", "in": "query", "required": false, "schema": { "type": "string", "description": "Sector label (enum at /v1/facets)" } }, { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "description": "Stage. Undisclosed = tech.eu deal-database rows whose source states no stage (stageEstimated). On customer plans a stage filter leaves those rows out and /v1/stats byStage counts them under Undisclosed; partner/internal keys match the stored stage unless stages=honest", "enum": [ "Pre-Seed", "Seed", "Series A", "Series B", "Series C", "Series D", "Series E", "Series F", "Growth", "Undisclosed" ] } }, { "name": "includeEstimated", "in": "query", "required": false, "schema": { "type": "boolean", "description": "true: on customer plans the stage filter also matches size-estimated stages (stageEstimated rows) and byStage counts them under their estimate" } }, { "name": "geo", "in": "query", "required": false, "schema": { "type": "string", "description": "Region (Türkiye, Europe, MENA, Americas, Asia, Africa) or HQ ISO-3166 alpha-2 country code. A code the data does not carry is a 400 naming /v1/facets (countries[].code lists the valid codes)" } }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string", "description": "HQ country, ISO-3166 alpha-2 (alternative to geo; same 400 rule)" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region name (alternative to geo)" } }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "description": "YYYY, YYYY-Qn or YYYY-Hn. Anything else is ignored (no filter) — check args in the response." } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "integer", "description": "First year (alternative to period)" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "integer", "description": "Last year (alternative to period)" } }, { "name": "dateFrom", "in": "query", "required": false, "schema": { "type": "string", "description": "First round date, strict YYYY-MM-DD (other formats are ignored)", "format": "date" } }, { "name": "dateTo", "in": "query", "required": false, "schema": { "type": "string", "description": "Last round date, strict YYYY-MM-DD", "format": "date" } }, { "name": "investor", "in": "query", "required": false, "schema": { "type": "string", "description": "Investor name (whole-name match, case-insensitive; aliases resolved, e.g. a16z → Andreessen Horowitz)" } }, { "name": "minAmountUSD", "in": "query", "required": false, "schema": { "type": "number", "description": "Minimum disclosed round size, USD" } }, { "name": "instrument", "in": "query", "required": false, "schema": { "type": "string", "description": "equity | debt | grant | secondary | venture (= equity rounds by startups: excludes public companies, corporates, infrastructure, government and funds)", "enum": [ "equity", "debt", "grant", "secondary", "venture" ] } }, { "name": "founderOrigin", "in": "query", "required": false, "schema": { "type": "string", "description": "Founder origin country, ISO-3166 alpha-2 (where the cited reporting names it)" } }, { "name": "market", "in": "query", "required": false, "schema": { "type": "string", "description": "Market, ISO-3166 alpha-2: rounds whose HQ is the country, OR whose founders are from it (founderOrigin rule), OR with at least one investor headquartered there. Each returned round then carries marketReasons. A malformed code is a 400", "pattern": "^[A-Za-z]{2}$" } }, { "name": "investorCountry", "in": "query", "required": false, "schema": { "type": "string", "description": "ISO-3166 alpha-2: rounds with at least one investor headquartered in the country (investor HQ from a curated list, GLEIF, or a ≥70% portfolio majority). A malformed code is a 400", "pattern": "^[A-Za-z]{2}$" } }, { "name": "g", "in": "query", "required": false, "schema": { "type": "string", "description": "month | quarter | year", "enum": [ "month", "quarter", "year" ] } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/facets": { "get": { "operationId": "getFacets", "summary": "Filter vocabularies and counts (not metered)", "parameters": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/events": { "get": { "operationId": "listEvents", "summary": "Fund closes, M&A (incl. SEC 8-K acquisitions), IPOs (SEC S-1/F-1 filing → 424B4 pricing, data.stage), private placements (Reg D Form D, Reg A+ Form 1-A; data.exemption), Reg CF crowdfunding offerings (SEC Form C: data.targetUSD, data.maxUSD, data.deadline, data.platform — an offering, not a raise; a closed one is a round with stageRaw 'Equity Crowdfunding'), launches", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "description": "Event type", "enum": [ "fund_close", "acquisition", "ipo", "private_placement", "crowdfunding_offering", "product_launch", "program_admission", "reg_action" ] } }, { "name": "geo", "in": "query", "required": false, "schema": { "type": "string", "description": "ISO2" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Rows per page (max 500)", "maximum": 500, "default": 50 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging offset (stops at the plan depth; see planLimit)" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "rows": { "type": "array", "items": { "type": "object" } }, "total": { "type": "integer", "description": "Matching rows (before plan depth)" }, "planLimit": { "$ref": "#/components/schemas/PlanLimit" } }, "required": [ "rows" ] } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/filings": { "get": { "operationId": "getFilings", "summary": "SEC filings of a company: the registrant(s) linked from its own EDGAR filings (legal name, CIK, tickers, SIC) and the latest filings with a direct link to each primary document", "parameters": [ { "name": "name", "in": "query", "required": true, "schema": { "type": "string", "description": "Company name" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/filings/unreported": { "get": { "operationId": "listUnreportedFilings", "summary": "SEC Form D placements of tech and biotech companies with no funding round in the record yet (filing facts, not estimates; venture-fund vehicles and listed issuers excluded). Paid plans; Free gets total with rows empty", "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "description": "Window on when the filing entered the record, 1-400", "default": 90 } }, { "name": "min", "in": "query", "required": false, "schema": { "type": "integer", "description": "Amount sold at least, US$ (offering amount when nothing is sold yet)" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "description": "Issuer name contains" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Rows per page (max 500)", "maximum": 500, "default": 100 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging offset (stops at the plan depth; see planLimit)" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "rows": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Event id" }, "company": { "type": "string", "description": "Issuer legal name as filed" }, "cik": { "type": "string", "description": "SEC CIK" }, "form": { "type": "string", "description": "D or D/A" }, "firstSaleDate": { "type": "string", "description": "Date of first sale (YYYY-MM-DD)" }, "seenAt": { "type": "string", "description": "When the filing entered the record (ISO-8601 UTC)" }, "amountSoldUSD": { "type": [ "number", "null" ], "description": "Total amount sold" }, "offeringUSD": { "type": [ "number", "null" ], "description": "Total offering amount" }, "industry": { "type": "string", "description": "Form D industry group" }, "geo": { "type": [ "string", "null" ], "description": "Issuer country ISO2 (US for US states)" }, "url": { "type": "string", "description": "SEC filing index" }, "status": { "type": "string", "description": "Always official (an SEC filing)" } } } }, "total": { "type": "integer", "description": "Matching rows (before plan depth)" }, "planLimit": { "$ref": "#/components/schemas/PlanLimit" } }, "required": [ "rows" ] } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/fund-marks": { "get": { "operationId": "getFundMarks", "summary": "Mutual funds' fair-value marks on a private company from SEC N-PORT: per period end × share class, the number of funds, median / min / max US$ per share and total value held, with a filing citation", "parameters": [ { "name": "name", "in": "query", "required": true, "schema": { "type": "string", "description": "Company name" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/news": { "get": { "operationId": "listNews", "summary": "Tech-ecosystem news items with citations", "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "description": "Category" } }, { "name": "geo", "in": "query", "required": false, "schema": { "type": "string", "description": "ISO2" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Rows per page (max 500)", "maximum": 500, "default": 50 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Paging offset (stops at the plan depth; see planLimit)" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "rows": { "type": "array", "items": { "type": "object" } }, "total": { "type": "integer", "description": "Matching rows (before plan depth)" }, "planLimit": { "$ref": "#/components/schemas/PlanLimit" } }, "required": [ "rows" ] } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/emerging": { "get": { "operationId": "getEmerging", "summary": "Sectors accelerating while still a small share", "parameters": [ { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "description": "Region" } }, { "name": "windowDays", "in": "query", "required": false, "schema": { "type": "integer", "description": "Window, default 60" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/top-investors": { "get": { "operationId": "listTopInvestors", "summary": "Investors ranked by co-investment centrality", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Rows" } } ], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/resolve": { "get": { "operationId": "resolveName", "summary": "Resolve a free-text name, or a website domain, to the exact company / investor names the other endpoints accept (not metered)", "description": "Use before /v1/company or /v1/investor when the name came from a user or another model: exact matches are flagged, close names are listed, and best is set only when one candidate clearly wins. With domain= instead of name=, the answer is {domain, matchedDomain, best, ambiguous, companies[]} from the websites stated in cited articles; best is set only for one company whose name is in the domain or whose website two or more articles state.", "parameters": [ { "name": "name", "in": "query", "required": false, "schema": { "type": "string", "description": "Free-text name, e.g. \"mistral\", \"a16z\", \"Peak XV\". Required unless domain is given." } }, { "name": "kind", "in": "query", "required": false, "schema": { "type": "string", "description": "company | investor (omit for both)", "enum": [ "company", "investor" ] } }, { "name": "domain", "in": "query", "required": false, "schema": { "type": "string", "description": "Website domain instead of a name, e.g. mistral.ai — scheme, www., port and path are ignored (https://www.mistral.ai/about = mistral.ai); a subdomain also tries its parent. Matched against the websites stated in cited articles. Used when name is absent." } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "best": { "type": [ "object", "null" ], "description": "The single confident match, or null when ambiguous", "properties": { "kind": { "type": "string" }, "name": { "type": "string" } } }, "companies": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "exact": { "type": "boolean" }, "raisedUSD": { "type": [ "number", "null" ] }, "rounds": { "type": [ "integer", "null" ] } } } }, "investors": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "exact": { "type": "boolean" }, "deals": { "type": [ "integer", "null" ] } } } } } } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/corrections": { "post": { "operationId": "reportCorrection", "summary": "Report a wrong field on a record (stored for review; not metered)", "description": "Needs an API key, an OAuth token or a signed-in session. The report goes to a review queue; the record is unchanged until a reviewer applies the correction. An identical open report from the same account returns the existing id (duplicate:true). At most 20 reports per account per rolling 24 hours (429 + Retry-After), plus 10 per minute per IP. The MCP tool report_correction takes the same fields.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "recordId", "field" ], "properties": { "recordId": { "type": "string", "description": "Round id (iNNNNNN, the id on every round row), event id, or a company / investor name" }, "recordKind": { "type": "string", "description": "round (default) | event | company | investor", "enum": [ "round", "event", "company", "investor" ] }, "field": { "type": "string", "description": "Field name as the API returns it, e.g. amountUSD, date, stage, geo, investors, leadInvestors, company" }, "proposedValue": { "type": "string", "description": "The correct value (proposedValue or note is required; max 2,000 characters)" }, "evidenceUrl": { "type": "string", "description": "http(s) URL of a source that states the correct value", "format": "uri" }, "note": { "type": "string", "description": "Context for the reviewer (max 2,000 characters)" } } } } } }, "responses": { "201": { "description": "Recorded", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "id": { "type": "integer" }, "status": { "type": "string", "description": "new" }, "duplicate": { "type": "boolean" }, "info": { "type": "string" } } } } } }, "400": { "description": "Missing or invalid field", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "No key or session", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "recordKind round/event: no record with that id", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited (Retry-After)", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "rate_limited" }, "info": { "type": "string" }, "retryAfter": { "type": "integer" } } } } } } } } }, "/v1/usage": { "get": { "operationId": "getUsage", "summary": "Your plan and this month's record meter (not metered)", "parameters": [], "responses": { "200": { "description": "OK", "headers": { "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Usage" } } } }, "400": { "description": "Invalid parameter (the body lists allowed values for enums)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials (WWW-Authenticate: Bearer)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "plan_required — the route is part of a higher plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Quota or rate limit exceeded", "headers": { "Retry-After": { "description": "Seconds until the limit resets", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Plan records per month (metered calls only)", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Records left this month before this response was counted", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "ISO-8601 time the monthly meter resets", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } } }, "502": { "description": "Upstream database error or timeout — retry", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } } }