> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opennous.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a person

> One person. Identity, title, the account they work at, stage, ICP fit, recent activity, and the deals they are on.

One person, with the account they work at, their stage, ICP fit, recent activity, and the deals they are on. Pass a UUID, email, or LinkedIn URL. To find someone by name, use `search` on [list people](/public-api/people/list).


## OpenAPI

````yaml GET /v2/people/{id}
openapi: 3.1.0
info:
  title: OpenNous REST API
  version: 2.0.0
  description: >-
    Read and write the OpenNous revenue context graph over HTTP. Authenticate
    with a workspace API key.
servers:
  - url: https://api.opennous.cloud
    description: OpenNous Cloud
security:
  - bearerAuth: []
  - apiKeyHeader: []
tags:
  - name: People
  - name: Accounts
  - name: Deals
  - name: Notes
  - name: Attention
  - name: Insights
  - name: Enrich & score
  - name: Organization
  - name: Workflows
  - name: Webhooks
    description: >-
      Subscribe to events and have them pushed to your own stack, with the
      account record attached.
  - name: Usage
paths:
  /v2/people/{id}:
    get:
      tags:
        - People
      summary: Get a person
      description: >-
        One person. Identity, title, the account they work at, stage, ICP fit,
        recent activity, and the deals they are on.
      operationId: getPerson
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Person entity UUID, email, or LinkedIn URL.
          example: sarah@acme.com
      responses:
        '200':
          description: The person.
          content:
            application/json:
              schema:
                type: object
                properties:
                  person:
                    $ref: '#/components/schemas/PersonDetail'
              example:
                person:
                  entity_id: 9b2f6c1e-4d3a-4f7e-9a51-2c8d7e3b1f40
                  name: Sarah Chen
                  first_name: Sarah
                  last_name: Chen
                  email: sarah@acme.com
                  linkedin_url: https://www.linkedin.com/in/sarahchen
                  title: VP Sales
                  seniority: vp
                  account:
                    entity_id: 3e7a1d52-8c4b-4b9e-a0f3-6d2c9e8b7a15
                    name: Acme
                    domain: acme.com
                  stage: discovery
                  icp:
                    score: 82
                    fit: true
                    tier: tier_1
                  last_activity_at: '2026-09-24T15:02:00Z'
                  recent_activity:
                    - id: a1
                      type: email_replied
                      occurred_at: '2026-09-24T15:02:00Z'
                      source: gmail
                      summary: Thursday works. Can you bring pricing for 40 seats?
                  stakeholder_of:
                    - deal_id: d3c1b2a0-5e4f-4a7b-9c8d-1e2f3a4b5c6d
                      name: Acme — 40 seats
                      stage: Discovery
                      status: open
                      amount: 48000
                      close_date: '2026-11-15'
        '400':
          description: '`id` is not a UUID, email, or LinkedIn URL.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: invalid_id
                detail: ':id must be a person entity UUID, an email, or a LinkedIn URL'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/UpgradeRequired'
        '404':
          description: No person matches, or the person is outside this key's book.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: person_not_found
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    PersonDetail:
      type: object
      properties:
        entity_id:
          type: string
          format: uuid
        name:
          type:
            - string
            - 'null'
        first_name:
          type:
            - string
            - 'null'
        last_name:
          type:
            - string
            - 'null'
        email:
          type:
            - string
            - 'null'
        linkedin_url:
          type:
            - string
            - 'null'
        title:
          type:
            - string
            - 'null'
        seniority:
          type:
            - string
            - 'null'
        account:
          type:
            - object
            - 'null'
          properties:
            entity_id:
              type: string
              format: uuid
            name:
              type:
                - string
                - 'null'
            domain:
              type:
                - string
                - 'null'
        stage:
          type:
            - string
            - 'null'
          enum:
            - identified
            - connected
            - interested
            - meeting_booked
            - discovery
            - demo
            - negotiation
            - closed_won
            - closed_lost
            - disqualified
            - churned
            - null
          description: How far this person's thread has gone.
        icp:
          type:
            - object
            - 'null'
          properties:
            score:
              type: integer
            fit:
              type: boolean
            tier:
              type:
                - string
                - 'null'
        last_activity_at:
          type:
            - string
            - 'null'
          format: date-time
        recent_activity:
          type: array
          description: The 10 latest activities, as summaries.
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
              occurred_at:
                type: string
                format: date-time
              source:
                type:
                  - string
                  - 'null'
              summary:
                type:
                  - string
                  - 'null'
        stakeholder_of:
          type: array
          description: Deals this person is a stakeholder on.
          items:
            type: object
            properties:
              deal_id:
                type: string
                format: uuid
              name:
                type: string
              stage:
                type:
                  - string
                  - 'null'
              status:
                type: string
                enum:
                  - open
                  - won
                  - lost
              amount:
                type:
                  - number
                  - 'null'
              close_date:
                type:
                  - string
                  - 'null'
    Error:
      type: object
      description: >-
        Every error response. `error` is a stable machine code. Some errors add
        fields such as `detail`, `supported`, `max`, or `reason`.
      required:
        - error
      properties:
        error:
          type: string
          description: Machine-readable error code.
        detail:
          type: string
          description: Human-readable explanation, when there is one.
      additionalProperties: true
  responses:
    Unauthorized:
      description: Missing, unknown, or expired API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            missing:
              summary: api_key_required
              value:
                error: api_key_required
            invalid:
              summary: invalid_api_key
              value:
                error: invalid_api_key
            expired:
              summary: api_key_expired
              value:
                error: api_key_expired
                detail: >-
                  This API key has expired. Create or rotate a key to get a
                  fresh one.
    UpgradeRequired:
      description: The workspace is past its monthly operations limit and grace window.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: upgrade_required
            reason: ops_limit_reached
            current_plan: starter
            upgrade_url: /settings?section=billing
    RateLimited:
      description: More than 600 requests in a minute on this key.
      headers:
        RateLimit-Limit:
          schema:
            type: integer
          description: Requests allowed per window.
        RateLimit-Remaining:
          schema:
            type: integer
          description: Requests left in the window.
        RateLimit-Reset:
          schema:
            type: integer
          description: Seconds until the window resets.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: rate_limited
    InternalError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: internal_error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Workspace API key. Create one in **Settings → API keys**.
    apiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: The same key, sent as a header.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.