company summary — just id, name, website, and a handful of other fields. The Companies API turns that id into the full picture: funding history, ratings, technologies, acquisitions, and H-1B sponsorship data.
Get a company profile
GET /api/companies/{id} returns the fully enriched CompanyDto — identity, social profiles, headquarters, funding rounds, third-party ratings, technologies, acquisitions, and H-1B statistics. See the Company object reference for the complete field list.
This endpoint is anonymous. It needs no API key, is free, and is CDN-cached. That’s what makes
company.details_url — the link embedded in every job’s company summary — safe to put directly in front of end users: it resolves from a browser with no auth wiring on your side.List a company’s jobs
GET /api/companies/{id}/jobs returns every job currently posted by one company.
page_size maxes out at 100. An unknown or nonexistent company ID returns 200 with an empty jobs array — not a 404 — so check the array length rather than the status code.
Enrich a company from its domain (beta)
Beta: available on activation. Company enrichment by domain is switched on per account. Email support@jobo.world to get access. Until it’s on, calls return
403 with code: company_enrichment_not_enabled and cost nothing.GET /api/companies/by-domain turns a domain into the same CompanyDto profile, for 3 credits per delivered profile.
202 with a status_url to poll. A 202 that started a new profiling run keeps its 3 credits, and the poll then delivers that profile at no further charge (or refunds the 3 credits if the run finds nothing). Polling is free until the profile is delivered.
Finding a company ID
You don’t look up company IDs directly; you get them from jobs:- Every job object’s
company.id(see the Job object reference). company.details_urlon that same embedded summary points straight at the profile endpoint, so you can link to it without constructing the URL yourself.
What enrichment covers
At a high level,CompanyDto groups into:
- Identity & social — trade and legal name, description, website, logo, LinkedIn/Crunchbase/GitHub and other social profile URLs.
- Corporate facts — headquarters, company size, revenue band, operating status, IPO status, ticker symbol.
- Funding — stage, total raised, investors, and a detailed round-by-round history.
- Company events — dated leadership-hire and layoff events.
- Reputation — employer ratings and review counts, where available.
- Products & technology — the tech stack, products offered, and software in use.
- Relationships — acquisitions, exits, and subsidiaries.
- H-1B data — sponsorships filed per year and by job title, for US companies.
[] and every scalar to null when Jobo doesn’t have the data — an empty list means “unknown,” not “the company has none.” See the Company object reference for the full field-by-field breakdown.
Errors
A missing or malformed company ID returns a standard error envelope — see Errors. Rate limiting on/jobs follows the same rules as the rest of the API; see Rate limits.