> ## Documentation Index > Fetch the complete documentation index at: https://developers.dealroom.co/llms.txt > Use this file to discover all available pages before exploring further. # List universities > Returns a paginated list of universities (entities with `organization_subtype = university`). The `university` sub-object carries alumni metrics (founder count, founded/unicorn companies). Supports the full entity filter syntax, sorting, and pagination. ## OpenAPI ````yaml /mintlify/openapi.yaml get /api/data/universities openapi: 3.1.0 info: title: Dealroom API version: '2026-07-06' description: >- REST API for the Dealroom platform — companies, funds, founders, investors, funding rounds, valuations, taxonomy, news, and aggregate analytics across all of them. Authentication uses Auth0 (Bearer JWT or OAuth2 client_credentials). All endpoints are versioned via the `API-Version` header (Stripe-style date-based versioning). contact: name: Dealroom API support email: support@dealroom.co url: https://dealroom.co termsOfService: https://dealroom.co/terms license: name: Proprietary — Dealroom commercial license url: https://dealroom.co/terms servers: - url: https://api-next.dealroom.co description: Production - url: https://api-next.beta.dealroom.co description: Beta - url: https://api-next.staging.dealroom.dev description: Staging security: - bearerAuth: [] - oauth2: [] tags: - name: Discovery description: API root discovery and functional namespaces. - name: Entities description: >- Companies, investors, people, universities, and other organisations. Filter, sort, and paginate the unified entity index. The term `investor` refers to the investment firm; `fund` refers to the capital vehicle it raises. - name: Companies description: >- Company profiles — the `organization_subtype = company` subset of entities (excludes investors, universities, and gov/NGOs). Same response shape as the entity index, scoped to companies. - name: Universities description: >- University profiles — the `organization_subtype = university` subset of entities. The `university` sub-object carries alumni metrics. - name: Government & NGO description: >- Government bodies and NGOs — the `organization_subtype = gov_ngo` subset of entities. - name: Transactions description: >- Funding rounds, equity events, debt, grants, exits, and other company-level financial events. - name: Valuations description: Company valuation history by year and month. - name: Investors description: >- Investor profiles (VCs, corporates, angels, family offices, governments). Subset of entities where `is_investor = true`. An investor is the firm that makes investments; the capital vehicles it raises are funds available via `/investors/{id}/funds`. - name: Funds description: >- Funds — the capital vehicles investor firms raise (e.g. "Fund III", $200M, 2024). Browse/filter by manager, type, size, and vintage; each fund links to its manager (GP). Fund size (`amount`) converts to the requested `?currency=` (default USD); `amount_source` carries the original native-currency amount. - name: People description: >- Person profiles (founders, executives, angels, and others). Subset of entities where `entity_type = 'person'`. Same response shape as founders, with company associations, education, and backgrounds. - name: Founders description: >- Founder profiles with company associations and education history. Subset of entities where `is_founder = true`. - name: News description: Curated news articles about companies, funds, deals, sectors, and events. - name: Jobs description: Active job openings posted by companies, with hiring-trend signals. - name: Aggregate description: >- Composable single- and multi-metric aggregations across companies, funding rounds, valuations, founders, and investors. - name: Funding Analytics description: 'Purpose-built analytics: 2D heatmaps, round transitions, capital funnels.' - name: Timeseries description: Yearly entity metrics (employees, revenue, valuation). - name: Matching description: >- Investor matching tool: ranked investor recommendations for a given deal profile. - name: Filters description: >- Filter registry discovery and value lookup. Use `/api/reference/filters` to discover available filters per scope and `/api/reference/filters/:key/values` to look up valid values. - name: Account description: User profile, authentication introspection, and account settings. - name: API Keys description: >- Self-service API key management. Programmatic (M2M) keys for server-side and Application (PKCE) keys for browser SPAs. - name: Teams description: Team membership and invitation management. - name: Usage description: Request-count usage analytics per API key for billing and introspection. - name: Metrics description: >- Service observability metrics (OpenTelemetry configuration and runtime counters). - name: Health description: Liveness probe (public, unauthenticated). - name: Search description: >- Cross-resource fuzzy search across companies, investors, people, universities, and government & NGO bodies. - name: Ecosystems description: >- Curated entity collections that can be filtered, navigated, and compared. Includes nested landscape resources. - name: Landscapes description: Saved entity lists within an ecosystem (e.g. "top fintech in NL"). - name: Enhancement Requests description: User-submitted profile data corrections routed to Dealroom Data Support. paths: /api/data/universities: get: tags: - Universities summary: List universities description: >- Returns a paginated list of universities (entities with `organization_subtype = university`). The `university` sub-object carries alumni metrics (founder count, founded/unicorn companies). Supports the full entity filter syntax, sorting, and pagination. operationId: listUniversities parameters: - schema: type: string description: > Filter expression for universities (organization_subtype = university) using nested syntax. Examples: - Single: alumni_founder_count[gte]:100 - AND: and(alumni_founder_count[gte]:100,location_country[eq]:233) Operators: eq, neq, gt, gte, lt, lte, in_any, nin_any Default ref: 'entity' (can be omitted for entity filters) example: and(alumni_founder_count[gte]:100,location_country[eq]:233) required: false name: filter in: query - schema: type: integer description: Number of results to return (1-500, default 25) format: int32 minimum: 1 maximum: 500 default: 25 example: 25 required: false name: limit in: query - schema: type: integer description: >- Number of results to skip before returning data. Combine with `limit` for offset-based pagination. format: int32 minimum: 0 default: 0 example: 0 required: false name: offset in: query - schema: type: string description: >- 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 required: false name: cursor in: query - schema: type: string description: >- Sort by one or more keys. Prefix with `-` for descending order; comma-separated for multi-key sorts. pattern: ^-?[\w,]+$ example: '-launch_date' required: false name: sort in: query - schema: type: boolean description: >- Pass `true` to include `page.total` (the matching record count) in the response. Default omits the total to avoid a count query. example: true required: false name: include_total in: query - schema: type: string description: >- ISO 4217 currency code for monetary field conversion. Defaults to USD. example: EUR required: false name: currency in: query responses: '200': description: List of universities content: application/json: schema: $ref: '#/components/schemas/UniversityListResponse' '401': description: >- Authentication required. The `Authorization` header was missing, the bearer token was malformed, or the token failed signature / expiry validation. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: >- Authentication succeeded but the caller's token does not include the permission required for this operation. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - oauth2: - read:entities - bearerAuth: - read:entities components: schemas: UniversityListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/Entity' page: type: object properties: total: type: number limit: type: number offset: type: number next_cursor: type: - string - 'null' description: >- Opaque cursor for the next page. Null when no further pages exist. prev_cursor: type: - string - 'null' description: >- Opaque cursor for the previous page. Null when on the first page. capped: type: boolean description: >- True when the requested page size was reduced to the per-tier/ecosystem row cap. tier: type: string enum: - anonymous - free - premium description: >- The access tier applied to this request (anonymous, free, premium). ecosystem: type: - string - 'null' description: >- Slug of the active ecosystem subdomain, or null when none is in scope. required: - limit - offset - next_cursor - prev_cursor currency: type: string required: - data - page - currency ErrorResponse: type: object properties: error: type: object properties: code: type: string message: type: string details: anyOf: - type: array items: type: object properties: path: type: string message: type: string required: - path - message - type: object additionalProperties: anyOf: - type: string - type: number - type: boolean required: - code - message required: - error Entity: type: object properties: uuid: type: string description: >- Stable UUID of the entity. This is the sole public identifier; numeric ids are not accepted on any entity endpoint. example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c type: type: - string - 'null' enum: - organization - person description: >- Top-level entity type — exactly one of `organization` or `person`. For organizations, `organization_subtype` carries the specific kind (company / university / gov_ngo / investor). Persons always have a null `organization_subtype`. example: organization organization_subtype: type: - string - 'null' enum: - company - university - gov_ngo - investor description: >- Organization subtype — one of `company`, `university`, `gov_ngo`, `investor`. Mutually exclusive. Set only when `type` is `organization`; always null for persons. example: company is_investor: type: - boolean - 'null' description: >- Stackable role flag — true when the entity makes investments. Independent of `type` / `organization_subtype`. example: false is_founder: type: - boolean - 'null' description: >- Stackable role flag — true when the person has a founder role. Person-level rollup; always false for organizations. example: false is_executive: type: - boolean - 'null' description: >- Stackable role flag — true when the person holds an executive role. Person-level rollup; always false for organizations. example: false is_partner: type: - boolean - 'null' description: >- Stackable role flag — true when the person holds a partner role (e.g. at an investment firm). Person-level rollup; always false for organizations. example: false total_invested: type: - number - 'null' description: >- Precomputed total amount this entity has invested across all rounds, in whole units of the active currency. Non-null only for entities that make investments (`is_investor = true`); null otherwise. example: 4200000000 name: type: string description: Display name of the entity. example: Stripe tagline: type: - string - 'null' description: Short, one-line marketing description (≤ ~140 chars). example: Online payment processing for internet businesses. about: type: - string - 'null' description: >- Long-form description / about text. Plain text, may span multiple sentences. example: Stripe builds economic infrastructure for the internet… image: type: - string - 'null' description: Absolute URL to the entity's logo image (PNG or JPEG, CDN-hosted). example: https://images.dealroom.co/logos/stripe.png dealroom_url: type: - string - 'null' description: Canonical URL on app.dealroom.co. example: https://app.dealroom.co/companies/stripe closing_year: type: - number - 'null' description: Year the entity was closed/shut down (null when still active). employee_count: type: - number - 'null' description: Number of employees. employee_count_1y_growth: type: - number - 'null' description: Year-over-year employee count growth percentage. launch_year: type: - number - 'null' description: Year the entity was founded. example: 2010 launch_month: type: - number - 'null' description: Month the entity was founded (1-12; null when unknown). example: 2 hq_country: type: - string - 'null' description: Country name of the entity's HQ. example: United States hq_city: type: - string - 'null' description: City of the entity's HQ. example: San Francisco website: type: - string - 'null' description: Full website URL. website_domain: type: - string - 'null' description: Domain name only (e.g. "stripe.com"). linkedin_url: type: - string - 'null' description: LinkedIn profile URL. example: https://www.linkedin.com/company/stripe twitter_url: type: - string - 'null' description: Twitter/X profile URL. example: https://twitter.com/stripe lat: type: - number - 'null' description: HQ latitude in decimal degrees. example: 37.7878 lon: type: - number - 'null' description: HQ longitude in decimal degrees. example: -122.4032 founding_country: type: - string - 'null' description: Country name where the entity was founded. example: United States founding_city: type: - string - 'null' description: City where the entity was founded. example: San Francisco founding_lat: type: - number - 'null' description: Founding location latitude in decimal degrees. example: 37.7878 founding_lon: type: - number - 'null' description: Founding location longitude in decimal degrees. example: -122.4032 company: type: object properties: is_unicorn: type: - boolean - 'null' is_vc_backed: type: - boolean - 'null' is_exited: type: - boolean - 'null' is_pe_owned: type: - boolean - 'null' is_hiring: type: - boolean - 'null' has_founder: type: - boolean - 'null' open_jobs_count: type: number description: >- Number of active job openings for the company (from the jobs table). 0 when none. example: 12 company_status: type: - string - 'null' signal_rating: type: - number - 'null' similarweb_3_months_growth: type: - number - 'null' description: '% growth in traffic over trailing 3 months.' similarweb_traffic: type: - number - 'null' description: Monthly site visits estimate from SimilarWeb. total_funding: type: - number - 'null' description: Total amount raised in active currency. total_vc_funding: type: - number - 'null' description: 'Subset of total_funding: VC-only funding.' unicorn_type: type: - string - 'null' description: Sub-category of unicorn (e.g. "centaur", "decacorn"). year_became_unicorn: type: - number - 'null' description: Year the company reached unicorn status. year_of_exit: type: - number - 'null' required: - is_unicorn - is_vc_backed - is_exited - is_pe_owned - is_hiring - has_founder - open_jobs_count - company_status - signal_rating - similarweb_3_months_growth - similarweb_traffic - total_funding - total_vc_funding - unicorn_type - year_became_unicorn - year_of_exit description: >- Company-specific attributes. Present only when `organization_subtype = company`. `company_status` is one of `operational`, `acquired`, `closed`, `low_activity`. person: type: object properties: gender: type: - string - 'null' is_serial_founder: type: - boolean - 'null' is_super_founder: type: - boolean - 'null' is_promising_founder: type: - boolean - 'null' is_strong_founder: type: - boolean - 'null' founded_companies_total_funding: type: - number - 'null' required: - gender - is_serial_founder - is_super_founder - is_promising_founder - is_strong_founder - founded_companies_total_funding investor: type: object properties: total_investments_count: type: - number - 'null' preferred_round: type: - string - 'null' last_investor_round_year: type: - number - 'null' last_investor_round_month: type: - number - 'null' required: - total_investments_count - preferred_round - last_investor_round_year - last_investor_round_month university: type: object properties: alumni_count: type: - number - 'null' alumni_founder_count: type: - number - 'null' alumni_founded_companies_count: type: - number - 'null' alumni_unicorn_companies_count: type: - number - 'null' spinout_count: type: - number - 'null' required: - alumni_count - alumni_founder_count - alumni_founded_companies_count - alumni_unicorn_companies_count - spinout_count funding_summary: type: object properties: total_funding: type: - number - 'null' description: >- Total amount raised across all rounds in the active currency, as a whole-unit integer. example: 9123000000 round_count: type: - number - 'null' description: Number of distinct funding rounds recorded for this entity. example: 28 required: - total_funding - round_count description: >- Aggregated funding totals for the entity. Present on companies that have at least one recorded funding round. tags: type: array items: type: object properties: id: type: number name: type: string type: type: string required: - id - name - type founders: type: array items: type: object properties: uuid: type: string description: Stable UUID of the founder. example: 1a2b3c4d-5e6f-7890-1234-567890abcdef name: type: string image: type: - string - 'null' dealroom_url: type: - string - 'null' is_investor: type: - boolean - 'null' description: >- True when the founder is also an investor (links to investor profile instead of person). is_strong_founder: type: - boolean - 'null' description: >- Dealroom's strong-founder signal. Strong founders sort first in this array, so callers surfacing one representative founder pick the one that satisfies a founder.is_strong_founder filter. required: - uuid - name - image - dealroom_url - is_investor - is_strong_founder latest_valuation: type: object properties: value: type: - number - 'null' year: type: - number - 'null' month: type: - number - 'null' required: - value - year - month latest_revenue: type: object properties: value: type: - number - 'null' year: type: - number - 'null' required: - value - year added_at: type: - string - 'null' description: >- ISO 8601 timestamp when this entity was created in Dealroom's source system ("added to Dealroom"). Distinct from created_at (data-loader sync time). Sort with `-added_at` for a newest-added-first feed. example: '2026-06-30T04:00:52.000Z' created_at: type: - string - 'null' description: ISO 8601 timestamp when this record was first loaded example: '2026-03-21T08:00:00.000Z' updated_at: type: - string - 'null' description: ISO 8601 timestamp when this record was last modified example: '2026-03-27T10:30:00.000Z' deleted_at: type: - string - 'null' description: ISO 8601 timestamp when this record was soft-deleted (null = active) example: null required: - uuid - type - organization_subtype - is_investor - is_founder - is_executive - is_partner - total_invested - name - tagline - about - image - dealroom_url - closing_year - employee_count - employee_count_1y_growth - launch_year - launch_month - hq_country - hq_city - website - website_domain - linkedin_url - twitter_url - lat - lon - founding_country - founding_city - founding_lat - founding_lon - added_at - created_at - updated_at - deleted_at securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Auth0 JWT access token. Paste a token obtained from your preferred OAuth2 flow. For machine-to-machine use, the OAuth2 client_credentials scheme below can mint a token directly from your `client_id` / `client_secret` inside the Swagger UI Authorize dialog. oauth2: type: oauth2 description: >- 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. flows: clientCredentials: tokenUrl: https://accounts.dealroom.co/oauth/token scopes: read:entities: Grant the read:entities permission read:transactions: Grant the read:transactions permission read:valuations: Grant the read:valuations permission read:investors: Grant the read:investors permission read:founders: Grant the read:founders permission read:dimensions: Grant the read:dimensions permission read:timeseries: Grant the read:timeseries permission read:aggregate: Grant the read:aggregate permission read:funding-analytics: Grant the read:funding-analytics permission read:ecosystems: Grant the read:ecosystems permission write:ecosystems: Grant the write:ecosystems permission delete:ecosystems: Grant the delete:ecosystems permission write:landscapes: Grant the write:landscapes permission delete:landscapes: Grant the delete:landscapes permission read:metrics: Grant the read:metrics permission create:api-keys: Grant the create:api-keys permission read:api-keys: Grant the read:api-keys permission delete:api-keys: Grant the delete:api-keys permission admin:api-keys: Grant the admin:api-keys permission read:usage: Grant the read:usage permission read:news: Grant the read:news permission read:jobs: Grant the read:jobs permission read:people: Grant the read:people permission read:teams: Grant the read:teams permission write:teams: Grant the write:teams permission delete:teams: Grant the delete:teams permission manage:team-members: Grant the manage:team-members permission read:search: Grant the read:search permission write:ai-features: Grant the write:ai-features permission ````