The company object

GET /api/companies/{id} returns this full profile. Jobs embed a slimmer preview whose details_url points here.

When no value is known, every list field is [], social_links is {}, and every nullable field is null. Treat an empty list as unknown, not as “the company has none”.

Fields

Identity and description

Field	Type	Nullable	Description
`id`	uuid	No	Stable Jobo company identifier. Use it as your primary key.
`name`	string	No	Trade name.
`legal_name`	string \| null	Yes	Registered legal entity name when distinct from the trade name (e.g. “Alphabet Inc.”).
`summary`	string \| null	Yes	Short company blurb.
`description`	string \| null	Yes	Longer marketing or about-us description.
`website`	string \| null	Yes	Company marketing website.
`ats_provider`	string \| null	Yes	The company’s ATS, as a source id (e.g. `greenhouse`), when detected.
`careers_url`	string \| null	Yes	The company’s own careers page, when found.
`listing_url`	string \| null	Yes	The company’s job board on its ATS (e.g. its Greenhouse, Lever, or Workday board).
`logo_url`	string \| null	Yes	Hosted logo URL.

Field	Type	Nullable	Description
`linkedin_url`	string \| null	Yes	Company LinkedIn profile URL.
`linkedin_company_id`	string \| null	Yes	LinkedIn numeric company identifier, when known.
`twitter_url`	string \| null	Yes	Company X (Twitter) profile URL.
`facebook_url`	string \| null	Yes	Company Facebook page URL.
`instagram_url`	string \| null	Yes	Company Instagram profile URL.
`angellist_url`	string \| null	Yes	Company AngelList (Wellfound) profile URL.
`youtube_url`	string \| null	Yes	Company YouTube channel URL.
`github_url`	string \| null	Yes	Company GitHub organization URL.
`g2_url`	string \| null	Yes	Company G2 page URL.
`crunchbase_url`	string \| null	Yes	Company Crunchbase profile URL.
`social_links`	object	No	Every social and review profile found, as platform key → URL (see below).

social_links keys: linkedin, twitter, facebook, instagram, youtube, github, g2, crunchbase, angellist, tiktok, glassdoor, xing, threads, bluesky, pinterest, vimeo, medium, kununu, trustpilot, indeed and mastodon. The flat *_url fields repeat the same URLs for the platforms that have one.

Location

Field	Type	Nullable	Description
`headquarters_location`	string \| null	Yes	Free-form headquarters address.
`headquarters_city`	string \| null	Yes	Headquarters city when known. Filled by Company Enrichment; always `null` on `GET /api/companies/{id}`.
`headquarters_region`	string \| null	Yes	Headquarters region or state, when known.
`headquarters_regions`	string[]	No	Additional region tags when more than one applies.
`country_code`	string \| null	Yes	ISO 3166-1 alpha-2 country code.
`continent`	string \| null	Yes	Continent name.

Basic facts and classification

Field	Type	Nullable	Description
`founding_year`	string \| null	Yes	Founding year as a string.
`company_size`	string \| null	Yes	Headcount band (see values).
`revenue`	string \| null	Yes	Annual revenue band (see values).
`is_agency`	boolean	No	True when the company is a staffing or recruitment agency.
`industries`	string[]	No	Vertical industry labels (e.g. `"HR & Staffing"`).
`primary_industry`	string \| null	Yes	Single high-level industry label (e.g. `"Finance"`).
`categories`	string[]	No	Business-model tags (see values).
`naics_codes`	string[]	No	NAICS industry codes.

Value lists

Field	Values
`company_size`	`1-10`, `11-50`, `51-200`, `201-500`, `501-1000`, `1001-5000`, `5001-10000`, `10001+`
`revenue`	`under-1m`, `1m-10m`, `10m-50m`, `50m-100m`, `100m-200m`, `200m-1b`, `over-1b`
`categories`	`b2b`, `b2c`, `b2b2c`, `b2g`, `saas`, `marketplace`, `e-commerce`, `service-provider`, `hardware`, `agency`, `nonprofit`, `government`, `education`

Filter jobs by company

These fields filter jobs on search and the job feed. Values match case-insensitively; the feed returns 400 for an unknown size or revenue band.

Company field	Search filter	Feed filter
`industries`	`industries`	`industries`
`categories`	`company_categories`	`company_categories`
`primary_industry`	—	`company_primary_industries`
`company_size`	—	`company_sizes`
`revenue`	—	`company_revenues`
`is_agency`	—	`company_is_agency`

Status and corporate state

Field	Type	Nullable	Description
`operating_status`	string \| null	Yes	`"active"` or `"closed"`.
`ipo_status`	string \| null	Yes	`"private"`, `"ipo"`, or `"delisted"`.
`company_type`	string \| null	Yes	`"for_profit"` or `"non_profit"`.
`stock_symbol`	string \| null	Yes	Ticker symbol when public.
`stock_exchange`	string \| null	Yes	Exchange code (e.g. `"NASDAQ"`).
`is_acquired`	boolean	No	True when the company has been acquired.
`acquired_by_company`	string \| null	Yes	Acquirer’s name, when acquired.
`parent_company_url`	string \| null	Yes	URL of the parent organization when this is a subsidiary.

Funding

Field	Type	Nullable	Description
`funding_stage`	string \| null	Yes	Funding stage tag (`"seed"`, `"series_a"`, …).
`total_funding`	string \| null	Yes	Human-formatted total raised (e.g. `"$120M"`).
`funds_total_formatted`	string \| null	Yes	Total funds raised when the company itself is a VC firm.
`investors`	string[]	No	Flat list of investor names.
`funding_rounds`	CompanyFundingRoundDto[]	No	Detailed funding rounds.

People and culture

Field	Type	Nullable	Description
`leadership_hires`	CompanyKeyEventDto[]	No	Dated leadership-hire events.
`layoffs`	CompanyKeyEventDto[]	No	Dated layoff events.
`ratings`	CompanyRatingDto[]	No	Employer ratings and review counts, where available.
`h1b_annual_job_counts`	CompanyH1bJobCountDto[]	No	H-1B sponsorships filed per year (US companies only).
`h1b_title_distribution`	CompanyH1bTitleDistributionDto[]	No	Distribution of H-1B sponsorships by job title.

Products and technology

Field	Type	Nullable	Description
`technologies`	string[]	No	Catalog slugs of technologies detected on the company’s website (`google-tag-manager`, `shopify`, …). Filter on this one.
`technology_mentions`	string[]	No	Technologies named in prose that don’t map to a catalog slug. Display only.
`technology_list`	string[]	No	Catalog names plus mentions, as one flat list.
`tech_stack`	CompanyTechnologyDto[]	No	Structured per-technology records.
`products`	CompanyProductDto[]	No	Products the company offers.
`software_used`	CompanyProductDto[]	No	Software the company is reported to use.
`research_focus_areas`	string[]	No	R&D topics or technologies the company is exploring.

Relationships

Field	Type	Nullable	Description
`acquisitions`	CompanyAcquisitionDto[]	No	Companies this company has acquired.
`exits`	CompanyExitDto[]	No	Exits attributed to this company.
`subsidiary_list`	string[]	No	Flat list of subsidiary names.
`sub_organizations`	CompanySubOrganizationDto[]	No	Structured sub-organization records.

Investor profile

Populated only when the company is itself an investor (VC firm, accelerator, etc.).

Field	Type	Nullable	Description
`investor_types`	string[]	No	Investor classification (e.g. `"venture_capital"`).

Ranking

Field	Type	Nullable	Description
`page_rank`	number \| null	Yes	Domain authority score (e.g. `7.51`). Use it to rank several matching companies.

Enrichment evidence

Filled by Company Enrichment. On GET /api/companies/{id} these fields are always null, {} or [].

Field	Type	Nullable	Description
`enrichment_state`	string \| null	Yes	`complete` or `partial` (see below).
`field_coverage`	object	No	Field name → `supported`, `unknown` or `stale` (see below).
`evidence_updated_at`	string (date-time) \| null	Yes	When the newest evidence behind the profile was fetched.
`business_evidence_checked_at`	string (date-time) \| null	Yes	When `sponsorship_evidence` and the job-listing entries of `technology_observations` were last refreshed.
`technology_observations`	CompanyTechnologyObservation[]	No	The evidence behind `technologies`, one entry per technology and source.
`sponsorship_evidence`	CompanySponsorshipEvidence[]	No	Visa sponsorship evidence from official registers, the company’s site and its job ads.

enrichment_state values:

complete: the profile passed verification with high confidence.
partial: identity confidence was low or the company’s site couldn’t be read. Expect fewer filled fields.

field_coverage values, keyed by field name:

supported: evidence backs the field.
unknown: no evidence backs the field.
stale (sponsorship_evidence only): its latest refresh failed, and the records shown come from an earlier one.

Nested objects

Each heading is the object’s schema name in the OpenAPI spec.

CompanyFundingRoundDto

Field	Type	Nullable	Description
`investment_type`	string \| null	Yes	Round type, e.g. `"seed"`, `"series_a"`.
`announced_on`	string \| null	Yes	Announcement date (typically `YYYY-MM-DD`).
`raised_amount`	string \| null	Yes	Human-formatted amount raised in the round (e.g. `"$25M"`).
`post_money_valuation`	string \| null	Yes	Post-money valuation, when disclosed.
`investor_count`	integer	No	Number of investors that participated.
`lead_investor`	string \| null	Yes	Name of the lead investor, when disclosed.

CompanyRatingDto

Field	Type	Nullable	Description
`source`	string \| null	Yes	Name of the site that publishes the rating.
`rating`	string \| null	Yes	Rating value as a string (e.g. `"4.2"`).
`url`	string \| null	Yes	Public URL of the rating page on the source site.
`review_count`	integer \| null	Yes	Number of reviews behind the rating, when reported.

CompanyH1bJobCountDto

Field	Type	Nullable	Description
`year`	string \| null	Yes	Calendar year as a string.
`count`	integer	No	Number of H-1B petitions sponsored that year.

CompanyH1bTitleDistributionDto

Field	Type	Nullable	Description
`title`	string \| null	Yes	Job title sponsored.
`count`	integer	No	Number of H-1B petitions filed for this title across reported years.

CompanyTechnologyDto

Field	Type	Nullable	Description
`name`	string \| null	Yes	Technology name (e.g. `"React"`).
`categories`	string[]	No	Category labels for the technology.

CompanyProductDto

Field	Type	Nullable	Description
`name`	string \| null	Yes	Product or software name.
`description`	string \| null	Yes	Short product description.

CompanyAcquisitionDto

Field	Type	Nullable	Description
`acquiree_name`	string \| null	Yes	Name of the acquired company.
`title`	string \| null	Yes	Headline for the acquisition.

CompanyExitDto

Field	Type	Nullable	Description
`name`	string \| null	Yes	Exit name.
`description`	string \| null	Yes	Short description of the exit.

CompanySubOrganizationDto

Field	Type	Nullable	Description
`name`	string \| null	Yes	Sub-organization name.
`ownership_type`	string \| null	Yes	Ownership type (e.g. `"subsidiary"`, `"division"`).
`title`	string \| null	Yes	Headline for the relationship.

CompanyKeyEventDto

A dated event in the company’s history, such as a layoff or a leadership hire.

Field	Type	Nullable	Description
`date`	string \| null	Yes	Event date (typically `YYYY-MM-DD`).

CompanyTechnologyObservation

One piece of evidence that the company uses a technology.

Field	Type	Nullable	Description
`technology_id`	string	No	Catalog slug, as in `technologies`.
`name`	string	No	Technology name.
`categories`	string[]	No	Catalog categories.
`usage_context`	string	No	What the evidence is (see below).
`quote`	string	No	The sentence, or the matched markup or DNS record.
`source_url`	string	No	Page or job listing the observation comes from.
`observed_at`	string (date-time)	No	When the source was read.
`confidence`	number	No	0 to 1.
`source_kind`	string \| null	Yes	`job_listing` when the observation comes from one of the company’s job listings on Jobo.

`usage_context`	Evidence	Adds to `technologies`
`explicit_use`	A sentence on the company’s pages or in its job ads says it uses it	Yes
`hiring_requirement`	A job ad asks for it	No
`website_detection`	A fingerprint in its markup	Yes
`dns_detection`	A record in its DNS zone	Yes

CompanySponsorshipEvidence

One record of visa sponsorship evidence. Register counts are summed over the record’s period.

Field	Type	Nullable	Description
`country`	string	No	ISO 3166-1 alpha-2 code of the register’s country; `unknown` for `company_statement` and `job_offer`.
`programme`	string	No	Visa programme or route as the source names it (`H-1B`, `PERM`, …); `unspecified` for a statement that names none.
`legal_employer`	string	No	Employer name as the source records it.
`evidence_kind`	string	No	What the record is (see below).
`source_url`	string	No	The register dataset, page or job listing.
`observed_at`	string (date-time)	No	When the source was retrieved.
`period`	string \| null	Yes	Reporting period of a register record, such as a fiscal year.
`registration_id`	string \| null	Yes	The employer’s identifier in the register.
`match_method`	string \| null	Yes	How a register record was matched (see below).
`quote`	string \| null	Yes	The sponsorship sentence, for `company_statement` and `job_offer`.
`filing_count`	integer \| null	Yes	Number of filings, for US Department of Labor records.
`requested_workers`	integer \| null	Yes	Workers requested across those filings, for US Department of Labor records.
`rating`	string \| null	Yes	The licence rating, where the register publishes one.
`source`	string \| null	Yes	The register: `uk`, `nl`, `us` (Department of Labor), `us-uscis`, `ca` or `ie`.
`approvals`	integer \| null	Yes	Approved petitions, positive LMIAs or permits issued, where published.
`denials`	integer \| null	Yes	Denied petitions, where published.
`approved_positions`	integer \| null	Yes	Positions approved by positive LMIAs (Canada).
`occupations`	string \| null	Yes	The most frequent occupations in the record (SOC or NOC titles), separated by `;` .

evidence_kind and source together say where a record comes from:

`evidence_kind`	`source`	From
`licence`	`uk`	UK register of licensed sponsors
`recognised_sponsor`	`nl`	Dutch register of recognised sponsors
`lca_filing`, `perm_filing`, `h2a_filing`, `h2b_filing`	`us`	US Department of Labor disclosure data
`uscis_petition_decisions`	`us-uscis`	USCIS H-1B Employer Data Hub
`lmia_positive`	`ca`	Canadian positive LMIA employers list
`employment_permits_issued`	`ie`	Irish employment permits issued to companies
`company_statement`	`null`	The company’s own site
`job_offer`	`null`	One of the company’s job ads

match_method values, from strongest to weakest: registration_id, verified_domain, legal_name_location, legal_name. The registers and their licenses are listed on Open data licenses and attribution.

Returned by

GET /api/companies/{id}, as the whole response body. The endpoint needs no API key and is free.
GET /api/companies/by-domain and GET /api/companies/by-domain/status, on a 200. Company Enrichment is a beta, available on activation; see Enrich companies.

Overview

Conventions

Jobs

Feed

Companies

Locations

Auto Apply

Fields

Identity and description

Location

Basic facts and classification

Value lists

Filter jobs by company

Status and corporate state

Funding

People and culture

Products and technology

Relationships

Investor profile

Ranking

Enrichment evidence

Nested objects

CompanyFundingRoundDto

CompanyRatingDto

CompanyH1bJobCountDto

CompanyH1bTitleDistributionDto

CompanyTechnologyDto

CompanyProductDto

CompanyAcquisitionDto

CompanyExitDto

CompanySubOrganizationDto

CompanyKeyEventDto

CompanyTechnologyObservation

CompanySponsorshipEvidence

Returned by

​Fields

​Identity and description

​Social profiles

​Location

​Basic facts and classification

​Value lists

​Filter jobs by company

​Status and corporate state

​Funding

​People and culture

​Products and technology

​Relationships

​Investor profile

​Ranking

​Enrichment evidence

​Nested objects

​CompanyFundingRoundDto

​CompanyRatingDto

​CompanyH1bJobCountDto

​CompanyH1bTitleDistributionDto

​CompanyTechnologyDto

​CompanyProductDto

​CompanyAcquisitionDto

​CompanyExitDto

​CompanySubOrganizationDto

​CompanyKeyEventDto

​CompanyTechnologyObservation

​CompanySponsorshipEvidence

​Returned by

Fields

Identity and description

Social profiles

Location

Basic facts and classification

Value lists

Filter jobs by company

Status and corporate state

Funding

People and culture

Products and technology

Relationships

Investor profile

Ranking

Enrichment evidence

Nested objects

CompanyFundingRoundDto

CompanyRatingDto

CompanyH1bJobCountDto

CompanyH1bTitleDistributionDto

CompanyTechnologyDto

CompanyProductDto

CompanyAcquisitionDto

CompanyExitDto

CompanySubOrganizationDto

CompanyKeyEventDto

CompanyTechnologyObservation

CompanySponsorshipEvidence

Returned by