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

# Enrich people

> Enrich a single lead account with firmographic data. No email or phone included.

**Rate limit:** 500 requests per day



## OpenAPI

````yaml POST /leads/single_enrich
openapi: 3.0.1
info:
  title: Pipecorn Accounts API
  description: Pipecorn Accounts API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://app.pipecorn.com/api/v2/
security:
  - defaultApiKey: []
paths:
  /leads/single_enrich:
    post:
      summary: Enrich a single lead account
      description: >-
        Enrich a single lead account with firmographic data. No email or phone
        included.


        **Rate limit:** 500 requests per day
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                first_name:
                  type: string
                  description: First name
                  example: Mathieu
                last_name:
                  type: string
                  description: Last name
                  example: Brun-Picard
                company_name:
                  type: string
                  description: Company name
                  example: Pipecorn
                linkedin_url:
                  type: string
                  format: uri
                  description: LinkedIn profile URL
                  example: https://www.linkedin.com/in/mathieu-brun-picard/
                live:
                  type: boolean
                  description: >-
                    Data source toggle. `true` (default) resolves the person
                    live from LinkedIn and returns the fully enriched profile.
                    `false` resolves the person from Pipecorn's people database
                    (Elasticsearch) instead: no LinkedIn call is made and no
                    LinkedIn integration is required, but email and phone are
                    not included and the response is the lighter
                    Pipecorn-formatted profile (`first_name`, `last_name`,
                    `full_name`, `linkedin_url`, `headline`, `current_title`,
                    `company_name`, `location`, `profile_image_url`). A
                    non-boolean value returns `422`.
                  default: true
                  example: true
              required:
                - first_name
                - last_name
                - company_name
      responses:
        '200':
          description: Successfully enriched lead
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadEnrichment'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (2 requests per minute)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    LeadEnrichment:
      type: object
      properties:
        status:
          type: string
          description: Qualification status of the lead
          example: QUALIFIED
        rejection_reason:
          type: string
          nullable: true
          description: Reason for rejection if the lead was not qualified
        first_name:
          type: string
          description: First name of the lead
        last_name:
          type: string
          description: Last name of the lead
        gender:
          type: string
          nullable: true
          description: Gender of the lead if available
        most_probable_email:
          type: string
          nullable: true
          description: Most likely email address for the lead
        most_probable_email_status:
          type: string
          nullable: true
          description: Status of the most probable email verification
        phones:
          type: array
          items:
            type: string
          description: List of phone numbers associated with the lead
        title:
          type: string
          description: Current job title
        linkedin_profile_url:
          type: string
          format: uri
          description: URL to the lead's LinkedIn profile
        linkedin_id_url:
          type: string
          format: uri
          description: LinkedIn ID URL of the lead
        regular_urn:
          type: string
          description: LinkedIn regular URN identifier
        lk_headline:
          type: string
          description: LinkedIn headline
        lk_connections_count:
          type: integer
          description: Number of LinkedIn connections
        years_in_position:
          type: integer
          nullable: true
          description: Number of years in current position
        months_in_position:
          type: integer
          nullable: true
          description: Number of months in current position
        years_in_company:
          type: integer
          nullable: true
          description: Number of years in current company
        months_in_company:
          type: integer
          nullable: true
          description: Number of months in current company
        current_position:
          type: object
          properties:
            posId:
              type: integer
              description: Position identifier
            title:
              type: string
              description: Job title
            current:
              type: boolean
              description: Whether this is the current position
            location:
              type: string
              description: Location of the position
            createdAt:
              type: integer
              description: Timestamp of when the position was created
            startedOn:
              type: object
              properties:
                year:
                  type: integer
              description: Start date information
            companyUrn:
              type: string
              description: Company URN identifier
            companyName:
              type: string
              description: Name of the company
            description:
              type: string
              description: Position description
        positions:
          type: array
          items:
            type: object
            properties:
              posId:
                type: integer
                description: Position identifier
              title:
                type: string
                description: Job title
              current:
                type: boolean
                description: Whether this is a current position
              location:
                type: string
                description: Location of the position
              startedOn:
                type: object
                properties:
                  year:
                    type: integer
                description: Start date information
              endedOn:
                type: object
                properties:
                  year:
                    type: integer
                description: End date information
              companyUrn:
                type: string
                description: Company URN identifier
              companyName:
                type: string
                description: Name of the company
              description:
                type: string
                description: Position description
              companyUrnResolutionResult:
                type: object
                properties:
                  entityUrn:
                    type: string
                    description: Resolved company URN
          description: List of all positions held by the lead
        title_description:
          type: string
          description: Description of the current title/role
        summary:
          type: string
          nullable: true
          description: Profile summary
        full_name:
          type: string
          description: Full name of the lead
        sales_navigator_profile_url:
          type: string
          nullable: true
          format: uri
          description: URL to the lead's Sales Navigator profile
        profile_image_url:
          type: string
          format: uri
          description: URL to the lead's profile image
        connection_degree:
          type: integer
          description: LinkedIn connection degree (1st, 2nd, 3rd)
        is_premium_linkedin:
          type: boolean
          nullable: true
          description: Whether the lead has LinkedIn Premium
        is_open_profile_linkedin:
          type: boolean
          nullable: true
          description: Whether the lead has an open LinkedIn profile
        is_open_to_work_linkedin:
          type: boolean
          nullable: true
          description: Whether the lead is open to work on LinkedIn
        past_position:
          type: object
          properties:
            posId:
              type: integer
              description: Position identifier
            title:
              type: string
              description: Job title
            current:
              type: boolean
              description: Whether this is a current position
            location:
              type: string
              description: Location of the position
            startedOn:
              type: object
              properties:
                year:
                  type: integer
              description: Start date information
            endedOn:
              type: object
              properties:
                year:
                  type: integer
              description: End date information
            companyName:
              type: string
              description: Name of the company
            description:
              type: string
              description: Position description
          description: Most recent past position
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
  securitySchemes:
    defaultApiKey:
      type: apiKey
      in: header
      description: Your API key
      name: X-API-KEY

````