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

# Look Up Company

> Look up a single company using its identifiers (domain, or professional network URL/ID). Returns the best matching company.

The Company Look Up endpoint returns a single company when you already know which one you are looking for. Provide an identifier and the API matches the best corresponding company.

You can look up a company by its **domain** or its **professional network URL or ID** for an exact match.

The response has the same shape as [Search Company](/api/v2/company/search/post), but always contains at most one company.

[Search API pricing](/api/v2/general/credit)


## OpenAPI

````yaml api/v2/reference/openapi.yml POST /company/lookup
openapi: 3.1.0
info:
  title: FullEnrich API Documentation
  version: 2.0.0
  description: >
    FullEnrich API enables you to enrich B2B contacts with emails and phone
    numbers using data from 20+ providers.


    We are GDPR and CCPA compliant.
servers:
  - url: https://app.fullenrich.com/api/v2
security: []
paths:
  /company/lookup:
    post:
      summary: Look up company
      description: >-
        Look up a single company using its identifiers (domain, or professional
        network URL/ID). Returns the best matching company.
      operationId: postCompanyLookup
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LookUpCompanyRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/LookUpCompanyResponse'
                  - $ref: '#/components/schemas/LookUpMetadata'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                AuthorizationHeaderNotSet:
                  value:
                    code: error.authorization.not_set
                    message: Authorization headers not set
                AuthorizationHeaderNotAnBearer:
                  value:
                    code: error.authorization.not_bearer
                    message: Authorization headers do not have prefix 'bearer'
                UnknownApiKey:
                  value:
                    code: error.api.key
                    message: Unknown api key
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                RateLimitExceeded:
                  value:
                    code: error.rate.limit
                    message: Too many requests. Try again in 1m
      security:
        - BearerAuth: []
components:
  schemas:
    LookUpCompanyRequest:
      type: object
      description: >-
        Provide at least one identifier to match a single company. The domain or
        professional network URL/ID give the most reliable match.
      properties:
        domain:
          type: string
          description: Company domain to look up.
          example: anthropic.com
        professional_network_url:
          type: string
          description: Professional network URL of the company.
          example: https://www.linkedin.com/company/anthropic
        professional_network_id:
          type: integer
          description: Professional network ID of the company.
          example: 1883877
    LookUpCompanyResponse:
      type: object
      properties:
        companies:
          type: array
          description: >-
            Array containing the matching company. Returns an empty array if no
            match is found.
          items:
            $ref: '#/components/schemas/Company'
    LookUpMetadata:
      type: object
      properties:
        metadata:
          type: object
          properties:
            credits:
              type: number
              format: double
              description: Total number of credits consumed
              example: 0.25
    Error:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
    Company:
      type: object
      properties:
        id:
          type: string
          description: Unique company identifier
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        name:
          type: string
          description: Company name
          example: Anthropic
        domain:
          type: string
          description: Company domain
          example: anthropic.com
        description:
          type: string
          description: Company description
          example: >-
            AI safety and research company building reliable, interpretable, and
            steerable AI systems.
        year_founded:
          type: integer
          description: Year the company was founded. Returns 0 when unknown.
          example: 2021
        headcount:
          type: integer
          description: >-
            Exact number of employees. May return 0 even when headcount_range is
            available.
          example: 2610
        headcount_range:
          type: string
          description: >-
            Employee count range (e.g., '1-10', '11-50', '51-200', '201-500',
            '501-1000', '1001-5000', '5001-10000', '10001+')
          example: 1001-5000
        company_type:
          type: string
          description: >-
            Type of company (e.g., 'Public Company', 'Privately Held',
            'Nonprofit', 'Self-Employed', 'Partnership', 'Educational',
            'Government Agency')
          example: Privately Held
        locations:
          type: object
          description: Company location information
          properties:
            headquarters:
              type: object
              description: >-
                Main headquarters address with structured location fields. Can
                be an empty object when no headquarters data is available.
              allOf:
                - $ref: '#/components/schemas/CompanyAddress'
            offices:
              type: array
              description: >-
                Additional office locations. Only contains raw address lines
                (line1, line2) without structured city/region/country fields.
                Can be null or an empty array.
              nullable: true
              items:
                $ref: '#/components/schemas/OfficeAddress'
        social_profiles:
          type: object
          description: Company's social media profiles
          allOf:
            - $ref: '#/components/schemas/CompanySocialProfile'
        specialties:
          type: array
          description: Specialties associated with the company
          items:
            type: string
          example:
            - artificial intelligence
            - machine learning
            - AI safety
        industry:
          type: object
          description: Company industry information
          properties:
            main_industry:
              type: string
              description: >-
                Primary industry category (e.g., 'Software Development',
                'Computer Hardware Manufacturing', 'Financial Services',
                'Healthcare', 'Retail')
              example: Software Development
        revenue_range:
          type: string
          description: >-
            Annual revenue bracket. Omitted when unknown. See [Company
            Revenue](/api/v2/general/enums#company-revenue) for the full list of
            possible values.
          example: $10M-$50M
    CompanyAddress:
      type: object
      description: Structured headquarters address with parsed location fields
      properties:
        line1:
          type: string
          description: Address line 1 (street address)
          example: 548 Market St
        line2:
          type: string
          description: >-
            Address line 2 (full location string including city, region, postal
            code, and country code)
          example: San Francisco, CA 94105, US
        city:
          type: string
          description: City name
          example: San Francisco
        region:
          type: string
          description: State or region
          example: California
        country:
          type: string
          description: Country name
          example: United States
        country_code:
          type: string
          description: ISO country code
          example: US
    OfficeAddress:
      type: object
      description: >-
        Office address. Unlike headquarters, office addresses only contain raw
        address lines without parsed location fields.
      properties:
        line1:
          type: string
          description: Street address
          example: 111 8th Ave
        line2:
          type: string
          description: Full location string (city, region, postal code, country code)
          example: New York, NY 10011, US
    CompanySocialProfile:
      type: object
      properties:
        professional_network:
          type: object
          description: Professional network profile information
          properties:
            id:
              type: integer
              description: Professional network profile ID
              example: 1234
            url:
              type: string
              description: Full professional network profile URL
              example: https://www.linkedin.com/company/anthropic
            handle:
              type: string
              description: Professional network profile handle/username
              example: anthropic
            connection_count:
              type: integer
              description: Number of professional network followers
              example: 125000
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: string

````