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

# Company enrichment

> The full profile of a company, by domain (or website), LinkedIn company page, or both. Credits are consumed only when the company is found, and not again for a company enriched for you in the last 30 days.

**Cost:** 1 credit when the company is found. Free when it isn't, and free again within 30 days for a company you already paid for.



## OpenAPI

````yaml /openapi.json post /v1/enrich-company
openapi: 3.1.0
info:
  title: LeadVector API
  version: '1'
  description: >-
    Find and verify business emails and mobile numbers, enrich people and
    companies, and run your email campaigns, mailboxes and inbox. Send your API
    key in the `x-api-key` header.
servers:
  - url: https://prod.leadvector.app
    description: Production
security:
  - access-key: []
tags:
  - name: Authentication
    description: Check that an API key works.
  - name: Lookups
    description: >-
      Find business emails and mobile numbers, verify emails, and find the
      person behind an email.
  - name: Enrichment
    description: The full profile of a person or a company.
  - name: Campaigns
    description: Email campaigns and their sequences.
  - name: Leads
    description: A campaign's leads.
  - name: Email accounts
    description: The mailboxes campaigns send from, and their warmup.
  - name: Inbox
    description: Replies to your campaigns, in one inbox.
  - name: Webhooks
    description: Subscribe URLs to events, and read the events sent.
  - name: Campaign events
    description: >-
      A campaign's lifecycle: created, launched, paused, resumed, stopped,
      completed, deleted.
  - name: Lead events
    description: A lead joining a campaign, replying, being labelled, finishing or failing.
  - name: Email events
    description: Each step's email to a lead, sent or failed.
  - name: Inbox events
    description: Mail the inbox receives, and the replies and forwards sent from it.
  - name: Email account events
    description: A mailbox's connection, pause, cooldown, warmup health and deletion.
  - name: Lookup events
    description: >-
      A single lookup’s result, in the app, the extension or the API: an email
      or a mobile found, an email verified, a person or a company enriched.
  - name: Bulk job events
    description: A bulk job (a file of lookups) completing or failing.
  - name: List events
    description: A contact saved to one of the team’s lists.
  - name: Credit events
    description: The team’s credits running low, or out.
  - name: Test event
    description: The event an endpoint gets when you send it a test.
paths:
  /v1/enrich-company:
    post:
      tags:
        - Enrichment
      summary: Company enrichment
      description: >-
        The full profile of a company, by domain (or website), LinkedIn company
        page, or both. Credits are consumed only when the company is found, and
        not again for a company enriched for you in the last 30 days.


        **Cost:** 1 credit when the company is found. Free when it isn't, and
        free again within 30 days for a company you already paid for.
      operationId: ApiV1Controller_enrichCompany
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyEnrichmentDto'
      responses:
        '201':
          description: COMPANY_ENRICHED / NO_RESULT_FOUND
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyEnrichmentResponseDto'
        '400':
          description: >-
            COMPANY_IDENTIFIER_REQUIRED / DOMAIN_INVALID /
            PERSONAL_DOMAIN_NOT_SUPPORTED / LINKEDIN_COMPANY_URL_INVALID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponseDto'
        '401':
          description: API_KEY_REQUIRED / INVALID_API_KEY
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponseDto'
        '403':
          description: >-
            INSUFFICIENT_CREDITS / NO_ACTIVE_PLAN, or ACCOUNT_DEACTIVATED /
            TEAM_DEACTIVATED
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/CreditErrorResponseDto'
                  - $ref: '#/components/schemas/AccountBlockedErrorResponseDto'
        '429':
          description: RATE_LIMIT_EXCEEDED, with a Retry-After header
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitErrorResponseDto'
      security:
        - access-key: []
components:
  schemas:
    CompanyEnrichmentDto:
      type: object
      properties:
        domain:
          type: string
          example: acme.com
          description: >-
            The company domain or website URL (https://www.acme.com/about is
            read as acme.com). Not a personal mail domain such as gmail.com.
        linkedinUrl:
          type: string
          example: https://www.linkedin.com/company/acme
          description: The company page on LinkedIn (/company/<name>).
    CompanyEnrichmentResponseDto:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: COMPANY_ENRICHED
          description: COMPANY_ENRICHED, or NO_RESULT_FOUND with data null
        data:
          anyOf:
            - $ref: '#/components/schemas/CompanyEnrichmentDataDto'
            - type: 'null'
      required:
        - success
        - message
        - data
    ApiErrorResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          example: 401
        message:
          description: >-
            A code in capitals; the list of messages when the body fails
            validation; `Internal server error` for a 500.
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          example: INVALID_API_KEY
        error:
          type: string
          description: The status's name.
          example: Unauthorized
        traceId:
          type: string
          description: Quote it when you contact support.
          example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f
        timestamp:
          type: string
          example: '2026-11-03T09:41:12.000Z'
        path:
          type: string
          example: /v1/find-email
      required:
        - statusCode
        - message
        - traceId
        - timestamp
        - path
    CreditErrorResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          example: 401
        message:
          description: The error's code.
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          example: INSUFFICIENT_CREDITS
          enum:
            - INSUFFICIENT_CREDITS
            - NO_ACTIVE_PLAN
        error:
          type: string
          description: The status's name.
          example: Unauthorized
        traceId:
          type: string
          description: Quote it when you contact support.
          example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f
        timestamp:
          type: string
          example: '2026-11-03T09:41:12.000Z'
        path:
          type: string
          example: /v1/find-email
        code:
          type: string
          enum:
            - INSUFFICIENT_CREDITS
            - NO_ACTIVE_PLAN
          example: INSUFFICIENT_CREDITS
        feature:
          type: string
          example: EMAIL_FINDER
        required:
          type: number
          description: Credits the lookup needs, in hundredths of a credit.
          example: 100
        remaining:
          type: number
          description: Credits left on the plan, in hundredths of a credit.
          example: 40
      required:
        - statusCode
        - message
        - traceId
        - timestamp
        - path
        - code
    AccountBlockedErrorResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          example: 401
        message:
          description: The error's code.
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          example: ACCOUNT_DEACTIVATED
          enum:
            - ACCOUNT_DEACTIVATED
            - TEAM_DEACTIVATED
        error:
          type: string
          description: The status's name.
          example: Unauthorized
        traceId:
          type: string
          description: Quote it when you contact support.
          example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f
        timestamp:
          type: string
          example: '2026-11-03T09:41:12.000Z'
        path:
          type: string
          example: /v1/find-email
      required:
        - statusCode
        - message
        - traceId
        - timestamp
        - path
    RateLimitErrorResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          example: 401
        message:
          description: The error's code.
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          example: RATE_LIMIT_EXCEEDED
        error:
          type: string
          description: The status's name.
          example: Unauthorized
        traceId:
          type: string
          description: Quote it when you contact support.
          example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f
        timestamp:
          type: string
          example: '2026-11-03T09:41:12.000Z'
        path:
          type: string
          example: /v1/find-email
        limit:
          type: number
          description: Calls allowed per window.
          example: 10
        windowSeconds:
          type: number
          example: 60
        retryAfterSeconds:
          type: number
          description: Seconds until the next call is allowed.
          example: 6
      required:
        - statusCode
        - message
        - traceId
        - timestamp
        - path
        - limit
        - windowSeconds
        - retryAfterSeconds
    CompanyEnrichmentDataDto:
      type: object
      properties:
        uuid:
          type: string
          example: 0192f2c4-6a2b-7c4e-9d1a-3b5c7e9f1a2b
        enrichedAt:
          type: string
          example: '2026-10-21T09:30:00.000Z'
          description: >-
            When the profile was enriched. One under 30 days old is served
            without asking a provider again.
        name:
          example: Acme
          type:
            - string
            - 'null'
        legalName:
          example: Acme, Inc.
          type:
            - string
            - 'null'
        domain:
          example: acme.com
          type:
            - string
            - 'null'
        website:
          example: https://acme.com
          type:
            - string
            - 'null'
        otherWebsites:
          example:
            - acme.io
          type: array
          items:
            type: string
        description:
          example: Acme builds rockets.
          type:
            - string
            - 'null'
        shortDescription:
          example: Rockets.
          type:
            - string
            - 'null'
        linkedinUrl:
          example: linkedin.com/company/acme
          type:
            - string
            - 'null'
        linkedinId:
          example: '108037802'
          type:
            - string
            - 'null'
        type:
          example: Privately Held
          type:
            - string
            - 'null'
        industry:
          example: Software Development
          type:
            - string
            - 'null'
        industries:
          example:
            - saas
          type: array
          items:
            type: string
        keywords:
          example:
            - live chat
          type: array
          items:
            type: string
        specialties:
          example:
            - Customer Support
          type: array
          items:
            type: string
        sicCodes:
          example:
            - '7372'
          type: array
          items:
            type: string
        naicsCodes:
          example:
            - '511210'
          type: array
          items:
            type: string
        employeeCount:
          example: 1822
          type:
            - number
            - 'null'
        employeeRange:
          example: 1001-2000
          type:
            - string
            - 'null'
        employeesOnLinkedin:
          example: 437
          description: LinkedIn members who list the company
          type:
            - number
            - 'null'
        linkedinFollowers:
          example: 52000
          type:
            - number
            - 'null'
        foundedYear:
          example: 2011
          type:
            - number
            - 'null'
        revenue:
          anyOf:
            - $ref: '#/components/schemas/CompanyRevenueDto'
            - type: 'null'
        phone:
          example: '+14156733820'
          type:
            - string
            - 'null'
        email:
          example: info@acme.com
          type:
            - string
            - 'null'
        headquarters:
          anyOf:
            - $ref: '#/components/schemas/CompanyAddressDto'
            - type: 'null'
        locations:
          type: array
          items:
            $ref: '#/components/schemas/CompanyAddressDto'
        twitterUrl:
          example: https://x.com/acme
          type:
            - string
            - 'null'
        facebookUrl:
          example: https://www.facebook.com/acme
          type:
            - string
            - 'null'
        crunchbaseUrl:
          example: https://www.crunchbase.com/organization/acme
          type:
            - string
            - 'null'
        instagramUrl:
          example: https://www.instagram.com/acme
          type:
            - string
            - 'null'
        youtubeUrl:
          example: https://www.youtube.com/@acme
          type:
            - string
            - 'null'
        angellistUrl:
          example: https://angel.co/company/acme
          type:
            - string
            - 'null'
        blogUrl:
          example: https://acme.com/blog
          type:
            - string
            - 'null'
        logoUrl:
          example: https://logo.example.com/acme.png
          type:
            - string
            - 'null'
        tickerSymbol:
          example: ACME
          type:
            - string
            - 'null'
        stockExchange:
          example: NASDAQ
          type:
            - string
            - 'null'
        technologies:
          type: array
          items:
            $ref: '#/components/schemas/CompanyTechnologyDto'
        funding:
          anyOf:
            - $ref: '#/components/schemas/CompanyFundingDto'
            - type: 'null'
        headcountGrowth:
          anyOf:
            - $ref: '#/components/schemas/CompanyHeadcountGrowthDto'
            - type: 'null'
        departmentHeadcount:
          example:
            engineering: 120
            sales: 45
          additionalProperties:
            type: number
          description: Headcount per department
          type:
            - object
            - 'null'
        languages:
          example:
            - English
          type: array
          items:
            type: string
        attributes:
          example:
            isB2b: true
            hasPricing: true
          additionalProperties:
            type: boolean
          description: What the website offers
          type:
            - object
            - 'null'
        jobPostings:
          anyOf:
            - $ref: '#/components/schemas/CompanyJobPostingsDto'
            - type: 'null'
        emailProvider:
          example: Google
          description: Who hosts the company's mail
          type:
            - string
            - 'null'
        parentCompany:
          anyOf:
            - $ref: '#/components/schemas/RelatedCompanyDto'
            - type: 'null'
        ultimateParentCompany:
          anyOf:
            - $ref: '#/components/schemas/RelatedCompanyDto'
            - type: 'null'
        subsidiaries:
          type: array
          items:
            $ref: '#/components/schemas/RelatedCompanyDto'
      required:
        - uuid
        - enrichedAt
        - name
        - legalName
        - domain
        - website
        - otherWebsites
        - description
        - shortDescription
        - linkedinUrl
        - linkedinId
        - type
        - industry
        - industries
        - keywords
        - specialties
        - sicCodes
        - naicsCodes
        - employeeCount
        - employeeRange
        - employeesOnLinkedin
        - linkedinFollowers
        - foundedYear
        - revenue
        - phone
        - email
        - headquarters
        - locations
        - twitterUrl
        - facebookUrl
        - crunchbaseUrl
        - instagramUrl
        - youtubeUrl
        - angellistUrl
        - blogUrl
        - logoUrl
        - tickerSymbol
        - stockExchange
        - technologies
        - funding
        - headcountGrowth
        - departmentHeadcount
        - languages
        - attributes
        - jobPostings
        - emailProvider
        - parentCompany
        - ultimateParentCompany
        - subsidiaries
    CompanyRevenueDto:
      type: object
      properties:
        annual:
          example: 120000000
          description: A point estimate of annual revenue, in US dollars
          type:
            - number
            - 'null'
        min:
          example: 100000000
          type:
            - number
            - 'null'
        max:
          example: 250000000
          type:
            - number
            - 'null'
        printed:
          example: $100M-$250M
          type:
            - string
            - 'null'
      required:
        - annual
        - min
        - max
        - printed
    CompanyAddressDto:
      type: object
      properties:
        street:
          example: 221 River Street
          type:
            - string
            - 'null'
        city:
          example: Hoboken
          type:
            - string
            - 'null'
        state:
          example: New Jersey
          type:
            - string
            - 'null'
        postalCode:
          example: '07030'
          type:
            - string
            - 'null'
        country:
          example: United States
          type:
            - string
            - 'null'
        countryCode:
          example: US
          description: ISO 3166-1 alpha-2
          type:
            - string
            - 'null'
        rawAddress:
          example: 221 River Street, Hoboken, NJ 07030
          type:
            - string
            - 'null'
        latitude:
          example: 40.748295
          type:
            - number
            - 'null'
        longitude:
          example: -73.98556
          type:
            - number
            - 'null'
      required:
        - street
        - city
        - state
        - postalCode
        - country
        - countryCode
        - rawAddress
        - latitude
        - longitude
    CompanyTechnologyDto:
      type: object
      properties:
        name:
          type: string
          example: Salesforce
        category:
          example: Customer Relationship Management
          type:
            - string
            - 'null'
      required:
        - name
        - category
    CompanyFundingDto:
      type: object
      properties:
        totalAmount:
          example: 570000000
          type:
            - number
            - 'null'
        totalAmountPrinted:
          example: $570.0M
          type:
            - string
            - 'null'
        roundsCount:
          example: 5
          type:
            - number
            - 'null'
        investorsCount:
          example: 22
          type:
            - number
            - 'null'
        latestRoundDate:
          example: '2015-11-24'
          type:
            - string
            - 'null'
        latestRoundType:
          example: Series C
          type:
            - string
            - 'null'
        latestRoundAmount:
          example: 350000000
          type:
            - number
            - 'null'
        rounds:
          type: array
          items:
            $ref: '#/components/schemas/CompanyFundingRoundDto'
      required:
        - totalAmount
        - totalAmountPrinted
        - roundsCount
        - investorsCount
        - latestRoundDate
        - latestRoundType
        - latestRoundAmount
        - rounds
    CompanyHeadcountGrowthDto:
      type: object
      properties:
        sixMonths:
          example: 0.05
          description: Headcount change over six months, as a fraction
          type:
            - number
            - 'null'
        twelveMonths:
          example: 0.12
          type:
            - number
            - 'null'
        twentyFourMonths:
          example: 0.3
          type:
            - number
            - 'null'
      required:
        - sixMonths
        - twelveMonths
        - twentyFourMonths
    CompanyJobPostingsDto:
      type: object
      properties:
        activeCount:
          example: 3
          type:
            - number
            - 'null'
        activeTitles:
          example:
            - Account Executive
          type: array
          items:
            type: string
      required:
        - activeCount
        - activeTitles
    RelatedCompanyDto:
      type: object
      properties:
        name:
          example: Walmart
          type:
            - string
            - 'null'
        domain:
          example: walmart.com
          type:
            - string
            - 'null'
        website:
          example: https://www.walmart.com
          type:
            - string
            - 'null'
      required:
        - name
        - domain
        - website
    CompanyFundingRoundDto:
      type: object
      properties:
        date:
          example: '2021-01-01'
          type:
            - string
            - 'null'
        type:
          example: Series B
          type:
            - string
            - 'null'
        amount:
          example: 140000000
          type:
            - number
            - 'null'
        currency:
          example: USD
          type:
            - string
            - 'null'
        investors:
          example:
            - Google Ventures
          type: array
          items:
            type: string
        url:
          example: https://www.crunchbase.com/funding_round/acme-series-b
          type:
            - string
            - 'null'
      required:
        - date
        - type
        - amount
        - currency
        - investors
        - url
  securitySchemes:
    access-key:
      type: apiKey
      in: header
      name: x-api-key
      description: Your API key, from the API keys page of the app.

````

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