Skip to main content
The CompanyDto is the fully enriched company profile returned by GET /api/companies/{id}. It carries everything Jobo knows about a company — identity, social handles, location, operating status, funding history, leadership, products and tech stack, M&A activity, third-party ratings, and press. Lightweight previews of the same company (the object embedded in a job, or the rows returned by the Career Sites Feed) are deliberately slimmer. Fetch the full CompanyDto whenever you need the rich blocks.
Every list field defaults to [] and every scalar to null when no value is known. Treat an empty list as “we don’t know”, not “the company has none”.

​
CompanyDto

​
Identity & description

FieldTypeNullableDescription
iduuidNoStable Jobo company identifier — use as your primary key.
namestringNoTrade name.
legal_namestring | nullYesRegistered legal entity name when distinct from the trade name (e.g. “Alphabet Inc.”).
summarystring | nullYesShort company blurb.
descriptionstring | nullYesLonger marketing / about-us description.
websitestring | nullYesCompany marketing website.
listing_urlstring | nullYesCanonical careers / job-listing page URL on the company’s ATS.
logo_urlstring | nullYesHosted logo URL.

​
Social profiles

FieldTypeNullableDescription
linkedin_urlstring | nullYesCompany LinkedIn profile URL.
linkedin_company_idstring | nullYesLinkedIn numeric company identifier, when known.
twitter_urlstring | nullYesCompany X / Twitter profile URL.
facebook_urlstring | nullYesCompany Facebook page URL.
instagram_urlstring | nullYesCompany Instagram profile URL.
angellist_urlstring | nullYesCompany AngelList / Wellfound profile URL.
youtube_urlstring | nullYesCompany YouTube channel URL.
github_urlstring | nullYesCompany GitHub organization URL.
g2_urlstring | nullYesCompany G2 page URL.
crunchbase_urlstring | nullYesCompany Crunchbase profile URL.

​
Location

FieldTypeNullableDescription
headquarters_locationstring | nullYesFree-form headquarters address.
headquarters_regionstring | nullYesRegion / state when known (structured complement to the free-text address).
headquarters_regionsstring[]NoAdditional region tags when more than one applies.
country_codestring | nullYesISO 3166-1 alpha-2 country code.
continentstring | nullYesContinent name.
phone_numberstring | nullYesHeadquarters phone number.
email_addressstring | nullYesGeneral contact email.

​
Basic facts & classification

FieldTypeNullableDescription
founding_yearstring | nullYesFounding year as a string.
company_sizestring | nullYesHeadcount band, e.g. "1-10", "11-50", "51-200".
revenuestring | nullYesAnnual revenue band, e.g. "under-1m", "100m-200m", "over-1b".
is_agencybooleanNoTrue when the company is a staffing / recruitment agency.
industriesstring[]NoVertical industry labels (e.g. "HR & Staffing").
primary_industrystring | nullYesSingle high-level industry label (e.g. "Finance").
categoriesstring[]NoBusiness-model bucket tags (b2b, b2c, saas, service-provider).
naics_codesstring[]NoNAICS industry codes.

​
Status & corporate state

FieldTypeNullableDescription
operating_statusstring | nullYes"active" or "closed".
ipo_statusstring | nullYes"private", "ipo", or "delisted".
company_typestring | nullYes"for_profit" or "non_profit".
stock_symbolstring | nullYesTicker symbol when public.
stock_exchangestring | nullYesExchange code (e.g. "NASDAQ").
is_acquiredbooleanNoTrue when the company has been acquired.
acquired_by_companystring | nullYesAcquirer’s name, when acquired.
parent_company_urlstring | nullYesURL of the parent organization when this is a subsidiary.

​
Funding

FieldTypeNullableDescription
funding_stagestring | nullYesFunding stage tag ("seed", "series_a", …).
total_fundingstring | nullYesHuman-formatted total raised (e.g. "$120M").
funds_total_formattedstring | nullYesTotal funds raised when the company itself is a VC firm.
investorsstring[]NoFlat list of investor names.
funding_roundsCompanyFundingRoundDto[]NoDetailed funding rounds.

​
People & culture

FieldTypeNullableDescription
foundersstring[]NoNames of company founders.
leadershipCompanyLeaderDto[]NoKey people (CEO, founders, executives).
leadership_hiresCompanyKeyEventDto[]NoDated leadership-hire events.
layoffsCompanyKeyEventDto[]NoDated layoff events.
ratingsCompanyRatingDto[]NoThird-party employer ratings (Glassdoor, Indeed, etc.).
press_referencesCompanyPressReferenceDto[]NoRecent press / news mentions.
h1b_annual_job_countsCompanyH1bJobCountDto[]NoH1B sponsorships filed per year (US companies only).
h1b_title_distributionCompanyH1bTitleDistributionDto[]NoDistribution of H1B sponsorships by job title.

​
Products & technology

FieldTypeNullableDescription
technology_liststring[]NoFlat list of technologies the company is reported to use.
tech_stackCompanyTechnologyDto[]NoStructured per-technology records.
productsCompanyProductDto[]NoProducts the company offers.
software_usedCompanyProductDto[]NoSoftware the company is reported to use.
research_focus_areasstring[]NoR&D topics / technologies the company is exploring.

​
Relationships

FieldTypeNullableDescription
acquisitionsCompanyAcquisitionDto[]NoCompanies this company has acquired.
exitsCompanyExitDto[]NoExits attributed to this company.
subsidiary_liststring[]NoFlat list of subsidiary names.
sub_organizationsCompanySubOrganizationDto[]NoStructured sub-organization records.
featured_listsCompanyFeaturedListDto[]NoCurated lists the company appears on (e.g. Forbes 50).
event_appearancesCompanyEventAppearanceDto[]NoConferences / events the company appeared at.

​
Investor profile

Populated only when the company is itself an investor (VC firm, accelerator, etc.).
FieldTypeNullableDescription
investor_typesstring[]NoInvestor classification (e.g. "venture_capital").

​
Ranking

FieldTypeNullableDescription
page_ranknumber | nullYesDomain authority score (e.g. 7.51) — useful for ranking when multiple companies match a query.

​
Nested objects

​
CompanyFundingRoundDto

FieldTypeNullableDescription
investment_typestring | nullYesRound type, e.g. "seed", "series_a".
announced_onstring | nullYesAnnouncement date (typically YYYY-MM-DD).
raised_amountstring | nullYesHuman-formatted amount raised in the round (e.g. "$25M").
post_money_valuationstring | nullYesPost-money valuation, when disclosed.
investor_countintegerNoNumber of investors that participated.
lead_investorstring | nullYesName of the lead investor, when disclosed.

​
CompanyLeaderDto

FieldTypeNullableDescription
namestring | nullYesPerson’s full name.
titlestring | nullYesRole / title (e.g. "CEO", "CTO").
linkedin_urlstring | nullYesPerson’s LinkedIn profile URL, when known.
avatar_urlstring | nullYesHosted avatar / headshot URL, when known.

​
CompanyRatingDto

FieldTypeNullableDescription
sourcestring | nullYesRating source, e.g. "glassdoor", "indeed".
ratingstring | nullYesRating value as a string (e.g. "4.2").
urlstring | nullYesPublic URL to the rating page on the source site.
review_countinteger | nullYesNumber of reviews that back the rating, when reported.

​
CompanyPressReferenceDto

FieldTypeNullableDescription
urlstring | nullYesArticle URL.
posted_onstring | nullYesPublication date (typically YYYY-MM-DD).
titlestring | nullYesArticle headline.
publisherstring | nullYesPublisher / outlet name.

​
CompanyH1bJobCountDto

FieldTypeNullableDescription
yearstring | nullYesCalendar year as a string.
countintegerNoNumber of H1B petitions sponsored that year.

​
CompanyH1bTitleDistributionDto

FieldTypeNullableDescription
titlestring | nullYesJob title sponsored.
countintegerNoNumber of H1B petitions filed for this title across reported years.

​
CompanyTechnologyDto

FieldTypeNullableDescription
namestring | nullYesTechnology name (e.g. "React").
categoriesstring[]NoCategory labels for the technology.

​
CompanyProductDto

FieldTypeNullableDescription
namestring | nullYesProduct / software name.
descriptionstring | nullYesShort product description.

​
CompanyAcquisitionDto

FieldTypeNullableDescription
acquiree_namestring | nullYesName of the acquired company.
titlestring | nullYesHeadline for the acquisition.

​
CompanyExitDto

FieldTypeNullableDescription
namestring | nullYesExit name.
descriptionstring | nullYesShort description of the exit.

​
CompanySubOrganizationDto

FieldTypeNullableDescription
namestring | nullYesSub-organization name.
ownership_typestring | nullYesOwnership type (e.g. "subsidiary", "division").
titlestring | nullYesHeadline for the relationship.

​
CompanyFeaturedListDto

FieldTypeNullableDescription
titlestring | nullYesList name (e.g. "Forbes 50 AI Companies").
org_numinteger | nullYesNumber of organizations on the list.
funding_total_formattedstring | nullYesHuman-formatted total funding of all companies on the list.
funding_total_usdinteger (int64) | nullYesTotal funding of all companies on the list, in USD.

​
CompanyKeyEventDto

A dated event in the company’s history (layoff, leadership hire, etc.).
FieldTypeNullableDescription
datestring | nullYesEvent date (typically YYYY-MM-DD).

​
CompanyEventAppearanceDto

FieldTypeNullableDescription
appearance_typestring | nullYesRole at the event (e.g. "speaker", "sponsor").
eventstring | nullYesEvent name.
event_starts_onstring | nullYesEvent start date (typically YYYY-MM-DD).
imagestring | nullYesEvent image URL.