List similar companies

curl --request GET \
  --url https://api.beta.dealroom.app/data/companies/{id}/similar \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.beta.dealroom.app/data/companies/{id}/similar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.beta.dealroom.app/data/companies/{id}/similar",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.beta.dealroom.app/data/companies/{id}/similar"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.beta.dealroom.app/data/companies/{id}/similar")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "view": "full",
  "data": [
    {
      "uuid": "345d1ab6-33df-4759-9e17-0d0c0ec9ab1c",
      "type": "organization",
      "domain": "stripe.com",
      "name": "Stripe",
      "tagline": "<string>",
      "about": "<string>",
      "image": "<string>",
      "dealroom_url": "<string>",
      "links": {
        "website": "<string>",
        "linkedin": "<string>",
        "twitter": "<string>",
        "instagram": "<string>",
        "angellist": "<string>",
        "crunchbase": "<string>"
      },
      "locations": [
        {
          "role": "hq",
          "city": {
            "id": 123,
            "name": "<string>"
          },
          "state": {
            "id": 123,
            "name": "<string>"
          },
          "country": {
            "id": 123,
            "name": "<string>"
          },
          "continent": {
            "id": 123,
            "name": "<string>"
          },
          "lat": 123,
          "lon": 123
        }
      ],
      "roles": [
        "founder"
      ],
      "taxonomy": [
        {
          "id": 123,
          "name": "<string>",
          "type": "sector"
        }
      ],
      "launch_date": "2024-03",
      "closing_date": "2024-03",
      "employees_count": 123,
      "added_at": "<string>",
      "updated_at": "<string>",
      "subtype": "company",
      "classifications": [
        "startup"
      ],
      "employee_count_1y_growth": 123,
      "status": "operational",
      "signal_rating": 123,
      "unicorn_type": "<string>",
      "became_unicorn_date": "2024-03",
      "became_thoroughbred_date": "2024-03",
      "exit_date": "2024-03",
      "investor": {
        "rank": 123,
        "types": [
          {
            "id": 123,
            "name": "<string>",
            "code": "<string>"
          }
        ],
        "stages": [
          {
            "id": 123,
            "name": "<string>",
            "code": "<string>"
          }
        ],
        "deal_size": {
          "min": 123,
          "max": 123
        },
        "investments": {
          "count": 123,
          "total_invested": 123,
          "preferred_round": "<string>",
          "last_round_date": "2024-03"
        },
        "portfolio": {
          "rounds_count": 123,
          "total_valuation": 123,
          "companies": {
            "total": 123,
            "sort": "-last_round_date",
            "items": [
              {
                "is_lead": true,
                "rounds_count": 123,
                "last_round_date": "2024-03",
                "company": {
                  "uuid": "<string>",
                  "type": "organization",
                  "subtype": "company",
                  "name": "<string>",
                  "image": "<string>",
                  "dealroom_url": "<string>"
                }
              }
            ]
          }
        },
        "exits": {
          "count": 123,
          "total_value": 123,
          "pct": 123
        },
        "match": {
          "companies_count": 123,
          "invested": 123
        }
      },
      "funding": {
        "total": 123,
        "total_vc": 123,
        "rounds_count": 123
      },
      "valuation": {
        "value": 123,
        "year": 123,
        "month": 123
      },
      "jobs": {
        "is_hiring": true,
        "open_count": 123
      },
      "revenue": {
        "value": 123,
        "year": 123
      },
      "traffic": {
        "monthly_visits": 123,
        "growth_3m": 123
      },
      "patents": {
        "count": 123
      },
      "founders": {
        "total": 123,
        "sort": "-is_strong_founder,-signal_rating",
        "items": [
          {
            "raw_title": "<string>",
            "titles": [
              "<string>"
            ],
            "is_founder": true,
            "is_executive": true,
            "is_partner": true,
            "is_past": true,
            "start_date": "2024-03",
            "end_date": "2024-03",
            "person": {
              "uuid": "<string>",
              "type": "person",
              "subtype": null,
              "name": "<string>",
              "image": "<string>",
              "dealroom_url": "<string>",
              "classifications": [
                "serial_founder"
              ]
            }
          }
        ]
      },
      "available": [
        "founders"
      ]
    }
  ],
  "page": {
    "total": 123,
    "limit": 123,
    "offset": 123,
    "next_cursor": "<string>",
    "prev_cursor": "<string>",
    "capped": true,
    "tier": "anonymous",
    "ecosystem": "<string>"
  },
  "currency": "<string>"
}

GET

data

companies

{id}

similar

List similar companies

curl --request GET \
  --url https://api.beta.dealroom.app/data/companies/{id}/similar \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.beta.dealroom.app/data/companies/{id}/similar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.beta.dealroom.app/data/companies/{id}/similar",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.beta.dealroom.app/data/companies/{id}/similar"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.beta.dealroom.app/data/companies/{id}/similar")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "view": "full",
  "data": [
    {
      "uuid": "345d1ab6-33df-4759-9e17-0d0c0ec9ab1c",
      "type": "organization",
      "domain": "stripe.com",
      "name": "Stripe",
      "tagline": "<string>",
      "about": "<string>",
      "image": "<string>",
      "dealroom_url": "<string>",
      "links": {
        "website": "<string>",
        "linkedin": "<string>",
        "twitter": "<string>",
        "instagram": "<string>",
        "angellist": "<string>",
        "crunchbase": "<string>"
      },
      "locations": [
        {
          "role": "hq",
          "city": {
            "id": 123,
            "name": "<string>"
          },
          "state": {
            "id": 123,
            "name": "<string>"
          },
          "country": {
            "id": 123,
            "name": "<string>"
          },
          "continent": {
            "id": 123,
            "name": "<string>"
          },
          "lat": 123,
          "lon": 123
        }
      ],
      "roles": [
        "founder"
      ],
      "taxonomy": [
        {
          "id": 123,
          "name": "<string>",
          "type": "sector"
        }
      ],
      "launch_date": "2024-03",
      "closing_date": "2024-03",
      "employees_count": 123,
      "added_at": "<string>",
      "updated_at": "<string>",
      "subtype": "company",
      "classifications": [
        "startup"
      ],
      "employee_count_1y_growth": 123,
      "status": "operational",
      "signal_rating": 123,
      "unicorn_type": "<string>",
      "became_unicorn_date": "2024-03",
      "became_thoroughbred_date": "2024-03",
      "exit_date": "2024-03",
      "investor": {
        "rank": 123,
        "types": [
          {
            "id": 123,
            "name": "<string>",
            "code": "<string>"
          }
        ],
        "stages": [
          {
            "id": 123,
            "name": "<string>",
            "code": "<string>"
          }
        ],
        "deal_size": {
          "min": 123,
          "max": 123
        },
        "investments": {
          "count": 123,
          "total_invested": 123,
          "preferred_round": "<string>",
          "last_round_date": "2024-03"
        },
        "portfolio": {
          "rounds_count": 123,
          "total_valuation": 123,
          "companies": {
            "total": 123,
            "sort": "-last_round_date",
            "items": [
              {
                "is_lead": true,
                "rounds_count": 123,
                "last_round_date": "2024-03",
                "company": {
                  "uuid": "<string>",
                  "type": "organization",
                  "subtype": "company",
                  "name": "<string>",
                  "image": "<string>",
                  "dealroom_url": "<string>"
                }
              }
            ]
          }
        },
        "exits": {
          "count": 123,
          "total_value": 123,
          "pct": 123
        },
        "match": {
          "companies_count": 123,
          "invested": 123
        }
      },
      "funding": {
        "total": 123,
        "total_vc": 123,
        "rounds_count": 123
      },
      "valuation": {
        "value": 123,
        "year": 123,
        "month": 123
      },
      "jobs": {
        "is_hiring": true,
        "open_count": 123
      },
      "revenue": {
        "value": 123,
        "year": 123
      },
      "traffic": {
        "monthly_visits": 123,
        "growth_3m": 123
      },
      "patents": {
        "count": 123
      },
      "founders": {
        "total": 123,
        "sort": "-is_strong_founder,-signal_rating",
        "items": [
          {
            "raw_title": "<string>",
            "titles": [
              "<string>"
            ],
            "is_founder": true,
            "is_executive": true,
            "is_partner": true,
            "is_past": true,
            "start_date": "2024-03",
            "end_date": "2024-03",
            "person": {
              "uuid": "<string>",
              "type": "person",
              "subtype": null,
              "name": "<string>",
              "image": "<string>",
              "dealroom_url": "<string>",
              "classifications": [
                "serial_founder"
              ]
            }
          }
        ]
      },
      "available": [
        "founders"
      ]
    }
  ],
  "page": {
    "total": 123,
    "limit": 123,
    "offset": 123,
    "next_cursor": "<string>",
    "prev_cursor": "<string>",
    "capped": true,
    "tier": "anonymous",
    "ecosystem": "<string>"
  },
  "currency": "<string>"
}

Authorizations

Authorization

string

header

required

OAuth2 client-credentials flow against the Dealroom Auth0 tenant. Use the client_id / client_secret from a Programmatic API key. Tokens are valid for 24h — Swagger UI will reuse the same token across operations. Revoking or deactivating a key rejects it on the next request (within a ≤5-minute server-side cache window), not at token expiry.

Headers

API-Version

string<date>

Pin a Stripe-style date-based API version (YYYY-MM-DD). Omit to use the latest version (2026-10-09). A pinned version is supported for 30 days after it is superseded, after which it returns 400.

Example:

"2026-10-09"

Path Parameters

string<uuid>

required

Stable UUID of the entity. Numeric ids are not accepted.

Minimum string length: 1

Example:

"345d1ab6-33df-4759-9e17-0d0c0ec9ab1c"

Query Parameters

filter

string

Filter expression for companies (organization_subtype = company) using nested syntax.

Examples:

Single: total_funding[gte]:1000000
AND: and(total_funding[gte]:1000000,classification[in_any]:unicorn)
OR: or(hq_location[eq]:628061,hq_location[eq]:1297711)
Relationship path: investor.total_invested_usd[gte]:100000000

Operators: eq, neq, gt, gte, lt, lte, in_any, nin_any in_all / nin_all are available on repeated related-record filters and on the classification / roles flag sets. Default ref: 'entity' (can be omitted for entity filters)

Example:

"and(total_funding[gte]:1000000,classification[in_any]:unicorn)"

limit

integer<int32>

default:25

Number of results to return (1-500, default 25)

Required range: 1 <= x <= 500

Example:

25

cursor

string

Opaque cursor token from a previous response's page.next_cursor or page.prev_cursor. Round-trip it as-is — do not decode or modify.

Example:

"eyJ2IjoxLCJkIjoibmV4dCJ9"

sort

string

Sort by one or more keys. Prefix with - for descending order; comma-separated for multi-key sorts.

Pattern: ^(?:-?\w+)?(?:,(?:-?\w+)?)*$

Example:

"-launch_date"

include_total

boolean

Pass true to compute page.total (the matching record count). By default no count query runs and page.total is null.

Example:

true

currency

string

ISO 4217 currency code for monetary field conversion. Defaults to USD.

Example:

"EUR"

view

enum<string>

default:full

Which row shape to return, echoed as view in the response. full is the complete row, priced as a full record. summary drops the full-only blocks (founders, revenue, traffic, patents, alumni, founded_companies, career, education, portfolio, exits, match, rank) and is priced as a summary record.

Available options:

full,

summary

Example:

"summary"

Response

Similar companies

Companies — full rows
Companies — summary rows

Companies: full rows by default, summary rows with view=summary.

view

enum<string>

required

The view served: full rows.

Available options:

full

data

Company · object[]

required

Show child attributes

page

object

required

Show child attributes

currency

string

required

Objects

Endpoints

List similar companies

Authorizations

Headers

Path Parameters

Query Parameters

Response