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

# Get a fully enriched company profile by id



## OpenAPI

````yaml /openapi.yaml get /api/companies/{id}
openapi: 3.1.0
info:
  title: Jobo Enterprise API
  description: >
    The Jobo Enterprise API provides programmatic access to job listings,
    intelligent search,

    real-time feeds, automated job applications, and geocoding services.
  version: 1.0.0
  contact:
    name: Jobo Support
    url: https://jobo.world
    email: support@jobo.world
servers:
  - url: https://connect.jobo.world
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Jobs Search
    description: Search and retrieve job listings
  - name: Jobs Feed
    description: Bulk job feeds and expiration tracking
  - name: Career Sites Feed
    description: Bulk feed of newly discovered career sites with enriched company profiles
  - name: Companies
    description: Company profiles and company-scoped job listings
  - name: Auto Apply
    description: Automated job application sessions
  - name: Auto Apply Profiles
    description: Manage applicant profiles for auto-apply
  - name: Locations
    description: Geocoding and location services
paths:
  /api/companies/{id}:
    get:
      tags:
        - Companies
      summary: Get a fully enriched company profile by id
      operationId: getCompanyById
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique company identifier
      responses:
        '200':
          description: The requested company profile
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyDto'
        '404':
          description: Company not found or disabled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      security: []
components:
  schemas:
    CompanyDto:
      type: object
      description: Fully enriched company profile.
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        legal_name:
          type: string
          nullable: true
          description: Registered legal entity name when distinct from the trade name.
        summary:
          type: string
          nullable: true
          description: >-
            Short company blurb. AI-generated when available, otherwise the SEO
            meta-description / first paragraph from the enrichment source.
        description:
          type: string
          nullable: true
        website:
          type: string
          nullable: true
        listing_url:
          type: string
          nullable: true
          description: |
            Canonical careers / job-listing page URL on the company's ATS
            (e.g. its Greenhouse / Lever / Workday board). Populated by every
            discovery provider.
        logo_url:
          type: string
          nullable: true
        linkedin_url:
          type: string
          nullable: true
        linkedin_company_id:
          type: string
          nullable: true
        twitter_url:
          type: string
          nullable: true
        facebook_url:
          type: string
          nullable: true
        instagram_url:
          type: string
          nullable: true
        angellist_url:
          type: string
          nullable: true
        youtube_url:
          type: string
          nullable: true
        github_url:
          type: string
          nullable: true
        g2_url:
          type: string
          nullable: true
        crunchbase_url:
          type: string
          nullable: true
        headquarters_location:
          type: string
          nullable: true
        headquarters_region:
          type: string
          nullable: true
          description: Region/state when known.
        headquarters_regions:
          type: array
          items:
            type: string
          description: Additional region tags when more than one applies.
        country_code:
          type: string
          nullable: true
          description: ISO 3166-1 alpha-2 country code.
        continent:
          type: string
          nullable: true
        phone_number:
          type: string
          nullable: true
        email_address:
          type: string
          nullable: true
        founding_year:
          type: string
          nullable: true
        company_size:
          type: string
          nullable: true
          description: Headcount band (e.g. "1-10", "51-200").
        revenue:
          type: string
          nullable: true
          description: Annual revenue band (e.g. "under-1m", "100m-200m", "over-1b").
        is_agency:
          type: boolean
        industries:
          type: array
          items:
            type: string
          description: Vertical industry labels (e.g. "HR & Staffing").
        primary_industry:
          type: string
          nullable: true
          description: Single high-level industry label (e.g. "Finance").
        categories:
          type: array
          items:
            type: string
          description: Business-model bucket tags (b2b / b2c / saas / service-provider).
        naics_codes:
          type: array
          items:
            type: string
        operating_status:
          type: string
          nullable: true
          description: '"active" | "closed".'
        ipo_status:
          type: string
          nullable: true
          description: '"private" | "ipo" | "delisted".'
        company_type:
          type: string
          nullable: true
          description: '"for_profit" | "non_profit".'
        stock_symbol:
          type: string
          nullable: true
        stock_exchange:
          type: string
          nullable: true
        is_acquired:
          type: boolean
        acquired_by_company:
          type: string
          nullable: true
        parent_company_url:
          type: string
          nullable: true
          description: URL of the parent organization when this company is a subsidiary.
        funding_stage:
          type: string
          nullable: true
        total_funding:
          type: string
          nullable: true
        funds_total_formatted:
          type: string
          nullable: true
          description: Total funds raised when the company itself is a VC firm.
        investors:
          type: array
          items:
            type: string
        funding_rounds:
          type: array
          items:
            $ref: '#/components/schemas/CompanyFundingRoundDto'
        founders:
          type: array
          items:
            type: string
        leadership:
          type: array
          items:
            $ref: '#/components/schemas/CompanyLeaderDto'
        leadership_hires:
          type: array
          items:
            $ref: '#/components/schemas/CompanyKeyEventDto'
        layoffs:
          type: array
          items:
            $ref: '#/components/schemas/CompanyKeyEventDto'
        ratings:
          type: array
          items:
            $ref: '#/components/schemas/CompanyRatingDto'
        press_references:
          type: array
          items:
            $ref: '#/components/schemas/CompanyPressReferenceDto'
        h1b_annual_job_counts:
          type: array
          items:
            $ref: '#/components/schemas/CompanyH1bJobCountDto'
        h1b_title_distribution:
          type: array
          items:
            $ref: '#/components/schemas/CompanyH1bTitleDistributionDto'
        technology_list:
          type: array
          items:
            type: string
          description: Flat list of technologies the company is reported to use.
        tech_stack:
          type: array
          items:
            $ref: '#/components/schemas/CompanyTechnologyDto'
          description: Structured per-technology records.
        products:
          type: array
          items:
            $ref: '#/components/schemas/CompanyProductDto'
        software_used:
          type: array
          items:
            $ref: '#/components/schemas/CompanyProductDto'
        research_focus_areas:
          type: array
          items:
            type: string
        acquisitions:
          type: array
          items:
            $ref: '#/components/schemas/CompanyAcquisitionDto'
        exits:
          type: array
          items:
            $ref: '#/components/schemas/CompanyExitDto'
        subsidiary_list:
          type: array
          items:
            type: string
          description: Flat list of subsidiary company names.
        sub_organizations:
          type: array
          items:
            $ref: '#/components/schemas/CompanySubOrganizationDto'
        featured_lists:
          type: array
          items:
            $ref: '#/components/schemas/CompanyFeaturedListDto'
        event_appearances:
          type: array
          items:
            $ref: '#/components/schemas/CompanyEventAppearanceDto'
        investor_types:
          type: array
          items:
            type: string
          description: >-
            Investor classification (only populated when the company is itself
            an investor).
        page_rank:
          type: number
          format: double
          nullable: true
          description: Domain authority score (useful for ranking).
    ProblemDetails:
      type: object
      description: RFC 7807 problem details object returned for error responses.
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
    CompanyFundingRoundDto:
      type: object
      properties:
        investment_type:
          type: string
          nullable: true
        announced_on:
          type: string
          nullable: true
        raised_amount:
          type: string
          nullable: true
        post_money_valuation:
          type: string
          nullable: true
        investor_count:
          type: integer
        lead_investor:
          type: string
          nullable: true
    CompanyLeaderDto:
      type: object
      properties:
        name:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        linkedin_url:
          type: string
          nullable: true
        avatar_url:
          type: string
          nullable: true
    CompanyKeyEventDto:
      type: object
      description: A dated event in the company's history (layoff, leadership hire, etc.).
      properties:
        date:
          type: string
          nullable: true
    CompanyRatingDto:
      type: object
      properties:
        source:
          type: string
          nullable: true
        rating:
          type: string
          nullable: true
        url:
          type: string
          nullable: true
        review_count:
          type: integer
          nullable: true
    CompanyPressReferenceDto:
      type: object
      properties:
        url:
          type: string
          nullable: true
        posted_on:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        publisher:
          type: string
          nullable: true
    CompanyH1bJobCountDto:
      type: object
      properties:
        year:
          type: string
          nullable: true
        count:
          type: integer
    CompanyH1bTitleDistributionDto:
      type: object
      properties:
        title:
          type: string
          nullable: true
        count:
          type: integer
    CompanyTechnologyDto:
      type: object
      description: A technology entry in the company's tech stack.
      properties:
        name:
          type: string
          nullable: true
        categories:
          type: array
          items:
            type: string
    CompanyProductDto:
      type: object
      description: A product or piece of software the company offers / uses.
      properties:
        name:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
    CompanyAcquisitionDto:
      type: object
      properties:
        acquiree_name:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
    CompanyExitDto:
      type: object
      properties:
        name:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
    CompanySubOrganizationDto:
      type: object
      properties:
        name:
          type: string
          nullable: true
        ownership_type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
    CompanyFeaturedListDto:
      type: object
      properties:
        title:
          type: string
          nullable: true
        org_num:
          type: integer
          nullable: true
        funding_total_formatted:
          type: string
          nullable: true
        funding_total_usd:
          type: integer
          format: int64
          nullable: true
    CompanyEventAppearanceDto:
      type: object
      description: Conference / event the company appeared at.
      properties:
        appearance_type:
          type: string
          nullable: true
        event:
          type: string
          nullable: true
        event_starts_on:
          type: string
          nullable: true
        image:
          type: string
          nullable: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: API key provided by Jobo

````