> ## 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. # Get single founder > Returns the full founder profile by UUID (numeric IDs are not accepted). Includes biographic details, founder badges (super founder, serial founder, etc.), professional history, education, and links to founded companies. ## OpenAPI ````yaml /openapi.yaml get /data/founders/{id} openapi: 3.1.0 info: title: Dealroom API version: '2026-09-01' 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.beta.dealroom.app description: Beta 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: Filters description: >- Filter registry discovery and value lookup. Use `/reference/filters` to discover available filters per scope and `/reference/filters/:key/values` to look up valid values. - name: Health description: Liveness probe (public, unauthenticated). - name: Search description: >- Cross-resource fuzzy search across companies, investors, people, universities, and government & NGO bodies. paths: /data/founders/{id}: get: tags: - Founders summary: Get single founder description: >- Returns the full founder profile by UUID (numeric IDs are not accepted). Includes biographic details, founder badges (super founder, serial founder, etc.), professional history, education, and links to founded companies. operationId: getFounder parameters: - schema: type: string minLength: 1 format: uuid example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c description: Stable UUID of the entity. Numeric ids are not accepted. required: true description: Stable UUID of the entity. Numeric ids are not accepted. name: id in: path - $ref: '#/components/parameters/ApiVersion' responses: '200': description: Single founder content: application/json: schema: $ref: '#/components/schemas/FounderDetailResponse' headers: Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' '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' headers: Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' '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' headers: Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' '404': description: Founder not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' headers: Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' '429': description: Rate limit exceeded. headers: Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' Retry-After: schema: type: string description: Seconds to wait before retrying. example: '1' required: true description: Seconds to wait before retrying. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - oauth2: - read:founders - bearerAuth: - read:founders components: parameters: ApiVersion: name: API-Version in: header required: false schema: type: string format: date example: '2026-09-01' description: >- Pin a Stripe-style date-based API version (`YYYY-MM-DD`). Omit to use the latest version (`2026-09-01`). A pinned version is supported for 30 days after it is superseded, after which it returns `400`. schemas: FounderDetailResponse: type: object properties: data: $ref: '#/components/schemas/Founder' currency: type: string description: Currency the founder monetary fields are expressed in (default USD). example: EUR required: - data - currency ErrorResponse: type: object properties: error: type: object properties: code: type: string enum: - VALIDATION_ERROR - NOT_FOUND - UNAUTHORIZED - DATABASE_ERROR - UNKNOWN_FILTER - FILTER_VALIDATION_ERROR - UNSUPPORTED_OPERATOR - FILTER_PARSE_ERROR - QUERY_TIMEOUT - INTERNAL_SERVER_ERROR - INVALID_ENTITY_ID - PAGINATION_DEPTH_EXCEEDED - SCHEMA_ERROR - FORBIDDEN - EXTERNAL_SERVICE_ERROR - ACCOUNT_REQUIRED - SERVICE_UNAVAILABLE - RATE_LIMITED - LIST_LOCKED - PATH_RENAMED - ENDPOINT_REMOVED description: Stable machine-readable error code. 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 Founder: type: object properties: uuid: type: string description: >- Stable UUID of the founder. This is the sole public identifier; numeric ids are not accepted. example: 1a2b3c4d-5e6f-7890-1234-567890abcdef name: type: string description: Display name of the founder. example: Patrick Collison tagline: type: - string - 'null' description: Short biographic line (≤ ~140 chars). example: Co-founder and CEO of Stripe. image: type: - string - 'null' description: Profile photo URL. example: https://images.dealroom.co/people/patrick-collison.jpg dealroom_url: type: - string - 'null' description: Canonical URL on app.dealroom.co. example: https://app.dealroom.co/people/patrick-collison gender: type: - string - 'null' description: Self-reported or inferred gender label, when known. example: male is_serial_founder: type: - boolean - 'null' description: True when this person has founded more than one company. example: true is_super_founder: type: - boolean - 'null' description: >- Dealroom's super-founder badge — founder of a unicorn (or comparable outlier outcome). example: true is_promising_founder: type: - boolean - 'null' description: Dealroom's promising-founder signal. example: false is_strong_founder: type: - boolean - 'null' description: Dealroom's strong-founder signal. example: true launch_year: type: - number - 'null' description: Year the founder started their first recorded company (if known). example: 2010 signal_rating: type: - number - 'null' description: Dealroom founder signal score (1–97). Null when unavailable. founded_companies_total_funding: type: - number - 'null' description: >- Total funding raised across all companies this founder has founded, in the response `currency`. hq_country: type: - string - 'null' description: Country the founder is based in. example: United States hq_city: type: - string - 'null' description: City the founder is based in. example: San Francisco tags: type: array items: type: object properties: id: type: number name: type: string type: type: string required: - id - name - type education: type: array items: type: object properties: university_uuid: type: string university_name: type: string degree: type: - string - 'null' year_start: type: - number - 'null' year_end: type: - number - 'null' majors: type: array items: type: string required: - university_uuid - university_name - degree - year_start - year_end - majors universities: type: array items: type: object properties: id: type: number year_start: type: - number - 'null' year_end: type: - number - 'null' degree: type: - object - 'null' properties: id: type: number name: type: string required: - id - name majors: type: array items: type: object properties: id: type: number name: type: string required: - id - name university: type: object properties: uuid: type: string name: type: string image: type: - string - 'null' hq_city: type: - string - 'null' hq_country: type: - string - 'null' required: - uuid - name - image - hq_city - hq_country required: - id - year_start - year_end - degree - majors - university companies: type: array items: type: object properties: entity_uuid: type: string entity_name: type: string image: type: - string - 'null' hq_city: type: - string - 'null' hq_country: type: - string - 'null' total_funding: type: - number - 'null' latest_valuation: type: object properties: value: type: - number - 'null' year: type: - number - 'null' month: type: - number - 'null' required: - value - year - month signal_rating: type: - number - 'null' sector_tags: type: array items: type: object properties: id: type: number name: type: string required: - id - name industries: type: array items: type: object properties: id: type: number name: type: string required: - id - name is_founder: type: - boolean - 'null' is_executive: type: - boolean - 'null' is_partner: type: - boolean - 'null' is_past: type: - boolean - 'null' raw_title: type: - string - 'null' titles: type: array items: type: object properties: name: type: string required: - name year_start: type: - number - 'null' year_end: type: - number - 'null' required: - entity_uuid - entity_name - image - hq_city - hq_country - total_funding - latest_valuation - signal_rating - sector_tags - industries - is_founder - is_executive - is_partner - is_past - raw_title - titles - year_start - year_end backgrounds: type: array items: type: object properties: id: type: number name: type: string required: - id - name required: - uuid - name - tagline - image - dealroom_url - gender - is_serial_founder - is_super_founder - is_promising_founder - is_strong_founder - launch_year - signal_rating - founded_companies_total_funding - hq_country - hq_city headers: Deprecation: description: >- Present when the request pinned a superseded version: the date that version was deprecated (`YYYY-MM-DD`). schema: type: string format: date Sunset: description: >- Present when the request pinned a superseded version: the date the version stops working and requests begin returning `400` (`YYYY-MM-DD`). schema: type: string format: date 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. Revoking or deactivating a key rejects it on the next request (within a ≤5-minute server-side cache window), not at token expiry. 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 ````