> ## 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 ecosystems > > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — The `ecosystems` table is user-owned and not populated by the BigQuery loader. Fresh deployments return an empty list until ecosystems are created via POST. Returns every active ecosystem the caller can read. Ecosystems are curated, filter-backed entity collections (e.g. "Dutch fintech", "EU climate"); each ecosystem owns a set of landscapes (saved entity lists). Use `limit` / `offset` for paging. ## OpenAPI ````yaml /mintlify/openapi.yaml get /api/platform/ecosystems 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/platform/ecosystems: get: tags: - Ecosystems summary: List ecosystems description: >- > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — The `ecosystems` table is user-owned and not populated by the BigQuery loader. Fresh deployments return an empty list until ecosystems are created via POST. Returns every active ecosystem the caller can read. Ecosystems are curated, filter-backed entity collections (e.g. "Dutch fintech", "EU climate"); each ecosystem owns a set of landscapes (saved entity lists). Use `limit` / `offset` for paging. operationId: listEcosystems parameters: - schema: type: integer description: Number of results to return (1-2000, default 25) format: int32 minimum: 1 maximum: 2000 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 responses: '200': description: List of active ecosystems content: application/json: schema: $ref: '#/components/schemas/EcosystemListResponse' '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' security: - oauth2: - read:ecosystems - bearerAuth: - read:ecosystems components: schemas: EcosystemListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/Ecosystem' 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 required: - data - page 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 Ecosystem: type: object properties: id: type: number slug: type: string name: type: string description: type: - string - 'null' long_description: type: - string - 'null' filter: type: string jobs_filter: type: - string - 'null' region: type: - string - 'null' image_url: type: - string - 'null' geojson_url: type: - string - 'null' partner_logos: type: - array - 'null' items: type: object properties: name: type: string url: type: - string - 'null' image_url: type: string required: - name - url - image_url primary_color: type: - string - 'null' surface_color: type: - string - 'null' brand_surface_color: type: - string - 'null' anonymous_access: type: boolean currency: type: - string - 'null' description: Default display currency (ISO 4217); null = global default (USD). example: EUR ga_measurement_id: type: - string - 'null' description: GA4 measurement ID for this ecosystem; null → global fallback. example: G-KQFB2GR3HN tabs_config: type: - object - 'null' additionalProperties: {} is_active: type: boolean sort_order: type: number required: - id - slug - name - description - long_description - filter - jobs_filter - region - image_url - geojson_url - partner_logos - primary_color - surface_color - brand_surface_color - anonymous_access - currency - ga_measurement_id - tabs_config - is_active - sort_order 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 ````