Skip to main content

​
Base URL

All API requests use the following base URL:
The canonical OpenAPI document is available at /openapi.json.

​
Authentication

All endpoints require Bearer token authentication. See the Authentication page for details.

​
Endpoints

Choose the collection endpoint based on the entity the response should contain. POST /companies is the default for most company-sourcing workflows. Use POST /deals when the result should be funding rounds or when round filters must match historical deals rather than only each company’s latest deal. Use POST /investors for firms and POST /people for individuals.

​
Deals

  • POST /deals — Search rounds across complete company histories. Use it for round-level analysis where filters must match any historical deal. Deal records include full round details and reference related entities by ID.
  • GET /deals/ — Retrieve full details and related source articles for a single known funding round by UUID.
  • GET /deals//investors — Resolve a deal’s investor IDs into the full lineup, including firms, associated partners, angel investors, lead status, and profile links.

​
Companies

  • POST /companies — Default endpoint for company discovery. It returns company metadata and the full latest deal. latest_deal filters apply only to the most recent round; investor filters can match across all rounds.
  • GET /company — Get full company details and the latest funding round by UUID, domain, LinkedIn, or Crunchbase. Pass a known domain or LinkedIn URL directly instead of searching first.
  • GET /company/deals — Retrieve a company’s complete funding history, including related source articles for every deal, by any identifier.
  • GET /company/search — Resolve a fuzzy company name or uncertain identifier. Skip it when a reliable domain or LinkedIn URL is already available.

​
Investors

  • POST /investors — Discover investor firms. Investment filters identify qualifying portfolio companies and deals, then return participating firms. filtered_deal_count and filtered_lead_count count only deals matching those filters.
  • GET /investor — Get an investor firm’s full profile, statistics, and portfolio summary by UUID, domain, LinkedIn, or Crunchbase. Pass a known domain or LinkedIn URL directly.
  • GET /investor/deals — Retrieve an investor’s complete deal history, including related source articles for every deal, by any identifier.
  • GET /investor/search — Resolve a fuzzy firm name or uncertain identifier. Skip it when a reliable domain or LinkedIn URL is already available.

​
People

  • POST /people — Discover individuals. Company mode returns founders or employees and can filter on the current employer’s latest round without returning that funding data. Investor mode returns angels or lead partners attached to firms.
  • GET /person — Get full person detail by UUID, LinkedIn, Crunchbase, or Twitter. Pass a known LinkedIn URL directly instead of searching first.
  • GET /person/email — Unlock a person’s verified email by UUID, LinkedIn, Crunchbase, or Twitter. Available on non-trial Pro+, Enterprise, and API plans. New unlocks consume 5 credits; previously unlocked emails consume 0 credits.
  • GET /person/phone — Unlock a person’s verified phone number by UUID, LinkedIn, Crunchbase, or Twitter. Available on non-trial Pro+, Enterprise, and API plans. New unlocks consume 5 credits; previously unlocked numbers consume 0 credits.
  • GET /person/deals — Retrieve every deal a person has participated in as an investor (angel plus lead/firm deals), including related source articles.
  • GET /person/search — Resolve a fuzzy person name or uncertain identifier across both investors and non-investors. Skip it when a reliable LinkedIn URL is already available.

​
Filters

  • GET /industry/search — Look up industries and super categories by name with fuzzy matching and relevance scoring; optionally filter by type (INDUSTRY or SUPER_CATEGORY).
  • GET /location/search — Look up locations by name with fuzzy matching and relevance scoring; optionally filter by type (CITY, STATE, REGION, or COUNTRY).
locations, industries, and super_categories filters must use exact permalinks — a wrong value is silently ignored and returns zero results. Always resolve labels via the search endpoints above first. See Filtering & Permalinks for the full workflow and the round-type enum values. Use semantic search_query only when the industry taxonomy cannot express the requested niche; semantic results are capped at 150 matches.
See Endpoint and Filter Selection for complete route-selection rules, filter guidance, and common multi-endpoint workflows.

​
Alerts

  • GET /alerts — Retrieve saved alert data with all matching deals in a date range (up to 10 alerts per request). Available on Pro+ and Enterprise plans.
  • GET /alerts/configurations — List the authenticated user’s alert configurations (filters, frequency, descriptions). Available on Pro+ and Enterprise plans.
Both alert endpoints return credits_used: 0; they do not consume API credits.

​
Error Handling

All endpoints return consistent error responses:
Last modified on October 1, 2026