> ## 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 account

> Enrich a single company account with firmographic data.

By default the company is enriched live via LinkedIn (`live: true`). Set `live: false` to answer from Pipecorn's companies database (Elasticsearch) instead — no LinkedIn call or LLM validation, and no integration required. The `live: false` response is Pipecorn-formatted (snake_case) and differs from the live LinkedIn payload documented below.

**Rate limit:** 20 requests per second



## OpenAPI

````yaml POST /accounts/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:
  /accounts/single_enrich:
    post:
      summary: Enrich a single company account
      description: >-
        Enrich a single company account with firmographic data.


        By default the company is enriched live via LinkedIn (`live: true`). Set
        `live: false` to answer from Pipecorn's companies database
        (Elasticsearch) instead — no LinkedIn call or LLM validation, and no
        integration required. The `live: false` response is Pipecorn-formatted
        (snake_case) and differs from the live LinkedIn payload documented
        below.


        **Rate limit:** 20 requests per second
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                company_linkedin_url:
                  type: string
                  format: uri
                  description: LinkedIn company profile URL (regular or Sales Navigator)
                  example: https://linkedin.com/company/pipecorn
                name:
                  type: string
                  description: Company name
                  example: Pipecorn
                domain:
                  type: string
                  description: Company website domain
                  example: pipecorn.com
                country:
                  type: string
                  description: >-
                    Two-letter ISO country code (ISO 3166-1 alpha-2). Examples:
                    FR (France), US (United States), GB (United Kingdom), DE
                    (Germany), ES (Spain), IT (Italy)
                  example: FR
                live:
                  type: boolean
                  description: >-
                    Data source toggle. `true` (default) enriches the company
                    live via LinkedIn and returns the raw LinkedIn enrichment
                    payload documented below. `false` answers from Pipecorn's
                    companies database (Elasticsearch) instead — no LinkedIn
                    call or LLM validation is performed and no integration is
                    required — returning a Pipecorn-formatted (snake_case)
                    company document. A non-boolean value returns `422`.
                  default: true
                  example: true
      responses:
        '200':
          description: Successfully enriched company
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountEnrichment'
        '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:
    AccountEnrichment:
      type: object
      properties:
        name:
          type: string
          description: Company name
          example: Pipecorn
        description:
          type: string
          description: Company description
          example: |-
            Ready to hunt without running ?

            👨‍👩‍👦‍👦 Squad of 10 outbound experts +
            🦁 One tool to automate your campaigns
        industry:
          type: string
          description: Primary industry
          example: Technology, Information and Internet
        type:
          type: string
          description: Company type
          example: Privately Held
        employeeCount:
          type: integer
          description: Current number of employees
          example: 5
        flagshipCompanyUrl:
          type: string
          format: uri
          description: LinkedIn company profile URL
          example: https://www.linkedin.com/company/pipecorn/
        entityUrn:
          type: string
          description: LinkedIn company URN identifier
          example: urn:li:fs_salesCompany:104885158
        website:
          type: string
          description: Company website domain
          example: pipecorn.com
        employeeCountInfo:
          type: object
          description: Detailed employee count information
          properties:
            monthlyChange:
              type: integer
              description: Monthly employee count change
              example: -17
            employeeCount:
              type: integer
              description: Current number of employees
              example: 5
            employeeDisplayCount:
              type: string
              description: Employee count as a display string
              example: '5'
        companyPictureDisplayImage:
          type: object
          description: Company logo image information
          properties:
            artifacts:
              type: array
              items:
                type: object
                properties:
                  width:
                    type: integer
                    example: 200
                  fileIdentifyingUrlPathSegment:
                    type: string
                    example: >-
                      200_200/company-logo_200_200/0/1724258638180/pipecorn_logo?e=1753920000&v=beta&t=lkLO8u_KIjlFSsPuh_jbf47z0zPzEumAzAtxYGDsZlA
                  height:
                    type: integer
                    example: 200
            rootUrl:
              type: string
              format: uri
              example: >-
                https://media.licdn.com/dms/image/v2/D4D0BAQFbBl6GwyL9IA/company-logo_
        employeeCountRange:
          type: string
          description: Employee count range
          example: 2-10
        headquarters:
          type: object
          properties:
            country:
              type: string
              description: Country name
              example: France
            city:
              type: string
              description: City name
              example: Paris
        revenueRange:
          type: object
          properties:
            estimatedMinRevenue:
              type: object
              properties:
                currencyCode:
                  type: string
                  example: USD
                amount:
                  type: number
                  example: 500
                unit:
                  type: string
                  example: THOUSAND
            estimatedMaxRevenue:
              type: object
              properties:
                currencyCode:
                  type: string
                  example: USD
                amount:
                  type: number
                  example: 1
                unit:
                  type: string
                  example: MILLION
        employeeDisplayCount:
          type: string
          description: Employee count as a display string
          example: '5'
        location:
          type: string
          description: Full location string
          example: Paris, Île-de-France, France
    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

````