Skip to main content
GET
/
api
/
entities
List entities with filters
curl --request GET \
  --url https://api.example.com/api/entities \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "uuid": "<string>",
      "type": "<string>",
      "is_company": true,
      "is_investor": true,
      "is_university": true,
      "is_crowdfunding": true,
      "is_government": true,
      "is_non_profit": true,
      "is_founder": true,
      "name": "<string>",
      "tagline": "<string>",
      "image": "<string>",
      "dealroom_url": "<string>",
      "launch_year": 123,
      "hq_country": "<string>",
      "hq_city": "<string>",
      "lat": 123,
      "lon": 123,
      "created_at": "2026-03-21T08:00:00.000Z",
      "updated_at": "2026-03-27T10:30:00.000Z",
      "deleted_at": null,
      "tags": [
        {
          "id": 123,
          "name": "<string>",
          "type": "<string>"
        }
      ],
      "founders": [
        {
          "id": 123,
          "name": "<string>",
          "image": "<string>",
          "dealroom_url": "<string>"
        }
      ]
    }
  ],
  "page": {
    "limit": 123,
    "offset": 123,
    "total": 123
  }
}

Authorizations

Authorization
string
header
required

Auth0 JWT access token

Query Parameters

filter
string

Filter expression using nested syntax.

Examples:

  • Single: total_funding_usd[gte]:1000000
  • Explicit ref: entity.total_funding_usd[gte]:1000000
  • AND: and(total_funding_usd[gte]:1000000,is_unicorn[eq]:true)
  • OR: or(location[eq]:118871,location[eq]:1297711)
  • Nested: and(or(location[eq]:118871,location[eq]:1297711),total_funding_usd[gte]:1000000)
  • Cross-ref: investor__total_invested_usd[gte]:100000000

Operators: eq, neq, gt, gte, lt, lte, in_any, nin_any in_all / nin_all are only available on repeated related-record filters. Legacy aliases: in → in_any, nin → nin_any (deprecated, prefer canonical names). Default ref: 'entity' (can be omitted for entity filters) Cross-ref: Use double underscore (investor__field) for relationship filters

Example:

"and(total_funding_usd[gte]:1000000,location[eq]:233)"

limit
string

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

Example:

"25"

offset
string
Example:

"0"

sort
string
Pattern: ^-?[\w,]+$
Example:

"-launch_year"

include_total
enum<string>
Available options:
true,
false
Example:

"true"

Response

List of entities

data
object[]
required
page
object
required