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

# Retrieve a company



## OpenAPI

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

    real-time feeds, geocoding services, and a contract preview for
    callback-driven

    job applications. Auto Apply is coming soon and is not available in beta or
    production.
  version: '2026-07-21'
  contact:
    name: Jobo Support
    url: https://jobo.world
    email: support@jobo.world
  license:
    name: Proprietary — see terms of service
    url: https://jobo.world/terms
  termsOfService: https://jobo.world/terms
servers:
  - url: https://connect.jobo.world
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Jobs
    description: Search and retrieve job listings
  - name: Feed
    description: Bulk job feeds and expiration tracking
  - name: Companies
    description: Company profiles and company-scoped job listings
  - name: Auto Apply
    description: >-
      Coming soon: profileless applications answered through signed, typed HTTPS
      callbacks
  - name: Locations
    description: Geocoding and location services
paths:
  /api/companies/{id}:
    get:
      tags:
        - Companies
      summary: Retrieve a company
      operationId: getCompanyById
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Stable company UUID returned as `company.id` on each job.
      responses:
        '200':
          description: The requested company profile
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyDto'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Company not found or disabled
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/ServerError'
      x-codeSamples:
        - lang: cURL
          source: >
            # This endpoint is anonymous - no API key required.

            curl
            "https://connect.jobo.world/api/companies/b5e6f7a8-1234-5678-9abc-def012345678"
        - lang: Python
          source: |
            from jobo_enterprise import JoboClient

            with JoboClient(api_key="YOUR_API_KEY") as client:
                company = client.companies.get("b5e6f7a8-1234-5678-9abc-def012345678")
                print(company.name, company.website, company.industries)
components:
  schemas:
    CompanyDto:
      type: object
      description: Fully enriched company profile.
      required:
        - id
        - name
        - legal_name
        - summary
        - description
        - website
        - listing_url
        - logo_url
        - linkedin_url
        - linkedin_company_id
        - twitter_url
        - facebook_url
        - instagram_url
        - angellist_url
        - youtube_url
        - github_url
        - g2_url
        - crunchbase_url
        - headquarters_location
        - headquarters_region
        - headquarters_regions
        - country_code
        - continent
        - phone_number
        - email_address
        - founding_year
        - company_size
        - revenue
        - is_agency
        - industries
        - primary_industry
        - categories
        - naics_codes
        - operating_status
        - ipo_status
        - company_type
        - stock_symbol
        - stock_exchange
        - is_acquired
        - acquired_by_company
        - parent_company_url
        - funding_stage
        - total_funding
        - funds_total_formatted
        - investors
        - funding_rounds
        - founders
        - leadership
        - leadership_hires
        - layoffs
        - ratings
        - press_references
        - h1b_annual_job_counts
        - h1b_title_distribution
        - technology_list
        - tech_stack
        - products
        - software_used
        - research_focus_areas
        - acquisitions
        - exits
        - subsidiary_list
        - sub_organizations
        - featured_lists
        - event_appearances
        - investor_types
        - page_rank
      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), when available.
        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: 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
        code:
          type: string
          nullable: true
          description: Stable machine-readable code for Auto Apply domain errors.
        api_version:
          $ref: '#/components/schemas/AutoApplyApiVersion'
    CompanyFundingRoundDto:
      type: object
      required:
        - investment_type
        - announced_on
        - raised_amount
        - post_money_valuation
        - investor_count
        - lead_investor
      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
      required:
        - name
        - title
        - linkedin_url
        - avatar_url
      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
      required:
        - date
      description: A dated event in the company's history (layoff, leadership hire, etc.).
      properties:
        date:
          type: string
          nullable: true
    CompanyRatingDto:
      type: object
      required:
        - source
        - rating
        - url
        - review_count
      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
      required:
        - url
        - posted_on
        - title
        - publisher
      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
      required:
        - year
        - count
      properties:
        year:
          type: string
          nullable: true
        count:
          type: integer
    CompanyH1bTitleDistributionDto:
      type: object
      required:
        - title
        - count
      properties:
        title:
          type: string
          nullable: true
        count:
          type: integer
    CompanyTechnologyDto:
      type: object
      required:
        - name
        - categories
      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
      required:
        - name
        - description
      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
      required:
        - acquiree_name
        - title
      properties:
        acquiree_name:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
    CompanyExitDto:
      type: object
      required:
        - name
        - description
      properties:
        name:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
    CompanySubOrganizationDto:
      type: object
      required:
        - name
        - ownership_type
        - title
      properties:
        name:
          type: string
          nullable: true
        ownership_type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
    CompanyFeaturedListDto:
      type: object
      required:
        - title
        - org_num
        - funding_total_formatted
        - funding_total_usd
      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
      required:
        - appearance_type
        - event
        - event_starts_on
        - image
      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
    AutoApplyApiVersion:
      type: string
      description: Version of the profileless Auto Apply API contract.
      enum:
        - '2026-07-21'
      example: '2026-07-21'
    ApiRateLimitError:
      type: object
      description: API-key request-window rejection returned by rate-limit middleware.
      required:
        - error
        - detail
        - group
        - retry_after_seconds
      properties:
        error:
          type: string
          example: Rate limit exceeded
        detail:
          type: string
        group:
          type: string
          example: AutoApply
        retry_after_seconds:
          type: integer
          minimum: 0
          nullable: true
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
    TooManyRequests:
      description: Rate limit exceeded.
      headers:
        Retry-After:
          description: Seconds to wait before retrying.
          schema:
            type: integer
            minimum: 0
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
        application/json:
          schema:
            $ref: '#/components/schemas/ApiRateLimitError'
    ServerError:
      description: Unexpected server error.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: API key provided by Jobo

````