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

# Get person details

> Returns person details by LinkedIn URL or ID



## OpenAPI

````yaml GET /v0/persons
openapi: 3.1.0
info:
  title: Stardex API (v0)
  version: 0.0.1
  description: Stardex ATS legacy API.
servers:
  - url: https://api.stardex.ai
    description: Production API server
security:
  - bearerAuth: []
tags: []
paths:
  /v0/persons:
    get:
      tags:
        - people
      summary: Get person details by LinkedIn URL or ID
      description: Returns person details by LinkedIn URL or ID
      parameters:
        - schema:
            type: string
            format: uri
            description: The LinkedIn URL of the person
          required: false
          name: linkedin_url
          in: query
        - schema:
            type: string
            description: The ID of the person
          required: false
          name: person_id
          in: query
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnifiedGetPersonDetailsResponse'
              example:
                error: null
                data:
                  id: 123e4567-e89b-12d3-a456-426614174000
                  name: John Doe
                  linkedin_public_id: johndoe
                  first_name: John
                  last_name: Doe
                  current_job_title: Software Engineer
                  external_source_id: ext123
                  emails:
                    - contact_data_type: work
                      value: john@company.com
                  phones:
                    - contact_data_type: mobile
                      value: '+1234567890'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnifiedGetPersonDetailsResponse'
              example:
                error: Invalid LinkedIn URL
                data: null
        '404':
          description: Person not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnifiedGetPersonDetailsResponse'
              example:
                error: Person not found
                data: null
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnifiedGetPersonDetailsResponse'
              example:
                error: Internal server error
                data: null
components:
  schemas:
    UnifiedGetPersonDetailsResponse:
      type: object
      properties:
        error:
          type:
            - string
            - 'null'
          description: Error message, if any
        data:
          allOf:
            - $ref: '#/components/schemas/GetPersonDetailsData'
            - type:
                - object
                - 'null'
      required:
        - error
        - data
    GetPersonDetailsData:
      type: object
      properties:
        id:
          type: string
          description: The ID of the person
        name:
          type:
            - string
            - 'null'
          description: The name of the person
        linkedin_public_id:
          type:
            - string
            - 'null'
          description: The LinkedIn public ID
        first_name:
          type:
            - string
            - 'null'
          description: First name
        last_name:
          type:
            - string
            - 'null'
          description: Last name
        current_job_title:
          type:
            - string
            - 'null'
          description: Current job title
        external_source_id:
          type:
            - string
            - 'null'
          description: External system identifier
        emails:
          type: array
          items:
            $ref: '#/components/schemas/ContactValue'
          description: Email addresses
        phones:
          type: array
          items:
            $ref: '#/components/schemas/ContactValue'
          description: Phone numbers
      required:
        - id
        - name
        - linkedin_public_id
        - first_name
        - last_name
        - current_job_title
        - external_source_id
        - emails
        - phones
    ContactValue:
      type: object
      properties:
        contact_data_type:
          type:
            - string
            - 'null'
          description: Category of contact (work/personal/etc)
        value:
          type: string
          description: Contact value
      required:
        - contact_data_type
        - value
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Authenticate with a Bearer token: API key, OAuth token, or session
        token.

````