Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.beta.dealroom.co/llms.txt

Use this file to discover all available pages before exploring further.

Latest version: 2026-05-29 — Send API-Version: 2026-05-29 or omit the header to use it.

​
May 29, 2026

Version 2026-05-29 — Current

​
Removed is_ai_summarised from news articles

Breaking The is_ai_summarised field has been removed from news article responses. The upstream data source no longer provides this signal. Clients on the previous version will continue to receive is_ai_summarised: false until the sunset date. Affected endpoints
  • GET /api/news

​
May 25, 2026

Version 2026-05-25 — Deprecated. Sunset: 2027-05-29. Migrate to the latest version before this date.

​
Cursor (keyset) pagination

Addition List endpoints now support cursor (keyset) pagination alongside the existing ?limit= / ?offset= mode — both are first-class and no migration is required. Responses gain two new fields in the page envelope: next_cursor and prev_cursor, opaque tokens that can be round-tripped via ?cursor= to step through pages without paying the deep-offset scan cost. Every request — cursor-mode or offset-mode — gets minted cursor tokens back, so callers can switch to keyset at any point in a walk. When both ?cursor= and ?offset= are sent on the same request, the cursor wins and the offset is ignored. Existing ?limit=/?offset= requests continue to work unchanged and run classic SQL LIMIT/OFFSET. Clients pinned to an earlier API-Version see the previous { limit, offset, total } envelope unchanged — the new fields are stripped on the way out. Affected endpoints
  • GET /api/entities
  • GET /api/founders
  • GET /api/funding-rounds
  • GET /api/investors
  • GET /api/news
  • GET /api/transactions
  • GET /api/valuations

​
Funding sort keys renamed to date

Breaking The funding-round sort keys year and month have been replaced by a single date key (backed by the funding_date_ym column). Affects GET /api/transactions and GET /api/funding-rounds. Clients pinned to an earlier API-Version will continue to work — requests with sort=-year, sort=-month, or sort=-year,-month are rewritten to sort=-date until the sunset date. Affected endpoints
  • GET /api/funding-rounds
  • GET /api/transactions

​
When enabled, list endpoints use keyset SQL and expose next_cursor / prev_cursor in the response page envelope.

Behavioral When enabled, list endpoints use keyset SQL and expose next_cursor / prev_cursor in the response page envelope.

​
May 22, 2026

Version 2026-05-22 — Deprecated. Sunset: 2027-05-25. Migrate to the latest version before this date.

​
Monetary fields are integers, not strings

Breaking Monetary fields in responses (amount, valuation, total_funding, total_invested, latest_valuation.value, latest_revenue.value, founded_companies_total_funding, revenue, ebitda, etc.) are now JS numbers in whole units of the active currency. Previously they were strings like "85000000.00". Filter inputs for these fields now also reject fractional values — pass integers only. Affected endpoints
  • GET /api/entities
  • GET /api/founders
  • GET /api/funding-rounds
  • GET /api/investors
  • GET /api/news
  • GET /api/transactions
  • GET /api/valuations

​
May 13, 2026

Version 2026-05-13 — Deprecated. Sunset: 2027-05-22. Migrate to the latest version before this date.

​
Removed null placeholder fields from entities and news articles

Breaking The fund object (containing fund_size_usd, vintage_year, is_raising, fund_status) has been removed from entity responses. The language, relevance_score, and hub_score fields have been removed from news article responses. These fields were placeholder columns that were always null in production and have been dropped from the database. Affected endpoints
  • GET /api/entities
  • GET /api/founders
  • GET /api/investors
  • GET /api/news

​
April 10, 2026

Version 2026-04-10 — Deprecated. Sunset: 2027-05-13. Migrate to the latest version before this date.

​
Reverted short_description back to tagline

Breaking The short_description field has been renamed back to tagline on entity, investor, and founder responses. Clients on version 2026-04-02 will continue to receive short_description until the sunset date. Affected endpoints
  • GET /api/entities
  • GET /api/founders
  • GET /api/investors

​
April 2, 2026

Version 2026-04-02 — Deprecated. Sunset: 2027-04-10. Migrate to the latest version before this date.

​
Renamed tagline to short_description

Breaking The tagline field has been renamed to short_description on entity, investor, and founder responses. Clients on version 2026-03-16 will continue to receive tagline until the sunset date. Affected endpoints
  • GET /api/entities
  • GET /api/founders
  • GET /api/investors

​
March 16, 2026

Version 2026-03-16 — Deprecated. Sunset: 2027-04-02. Migrate to the latest version before this date.
Initial launch version. No breaking changes.