> ## 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. # Get single person > Returns the full person profile by UUID (numeric IDs are not accepted). Covers all person entities (founders, executives, angels, and others). Includes biographic details, professional history, education, and background tags. ## OpenAPI ````yaml /mintlify/openapi.yaml get /api/data/people/{id} 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/people/{id}: get: tags: - People summary: Get single person description: >- Returns the full person profile by UUID (numeric IDs are not accepted). Covers all person entities (founders, executives, angels, and others). Includes biographic details, professional history, education, and background tags. operationId: getPerson parameters: - schema: type: string minLength: 1 format: uuid description: Stable UUID of the entity. Numeric ids are not accepted. example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c required: true name: id in: path responses: '200': description: Single person content: application/json: schema: $ref: '#/components/schemas/PersonDetailResponse' '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' '404': description: Person not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - oauth2: - read:people - bearerAuth: - read:people components: schemas: PersonDetailResponse: type: object properties: data: $ref: '#/components/schemas/Person' currency: type: string description: Currency the person monetary fields are expressed in (default USD). example: EUR required: - data - 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 Person: 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: - number - 'null' latest_valuation_year: type: - number - 'null' latest_valuation_month: type: - number - 'null' 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 - latest_valuation_year - latest_valuation_month - 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 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 ````