Skip to main content
GET
Get Company Jobs
Display company-specific job listings on profile pages, highlight job opportunities from targeted companies, and track hiring trends by filtering jobs by category, employment type, and location type.

Endpoint

Path Parameters

company_slug
string
required
Unique identifier for the target company to search

Authentication

x-api-key
string
Your Hirebase API key. Optional — not enforced on this endpoint today.

Query Parameters

page
integer
default:"1"
Page number for pagination
⚠️ Known issue: consecutive pages may return overlapping jobs. Deduplicate by _id on the client until this is fixed.
limit
integer
default:"10"
Number of results per page
⚠️ Known issue: consecutive pages may return overlapping jobs. Deduplicate by _id on the client until this is fixed.
sort_by
string
Field to sort results by. Accepted values: "date_posted", "relevance", "salary", "yoe".
⚠️ Not currently applied — results are returned in a default order regardless of sort_by/sort_order.
sort_order
string
Sort direction ("asc" or "desc").
⚠️ Not currently applied — results are returned in a default order regardless of sort_by/sort_order.
job_board
string
Filter jobs by source job board (e.g., "iCIMS", "Greenhouse", "Lever", "Workable").
job_category
string
Filter jobs by job category (e.g., "Engineering Jobs", "Sales Jobs").

Response

jobs
array
An array of job objects associated with the company
job_categories
array
Array of job category objects representing classifications of jobs (e.g., “Engineering Jobs”, “Human Resources Jobs”)
total_count
number
Total number of matching job listings
page
number
Current page number of the response
limit
number
Number of jobs returned per page
total_pages
number
Total number of pages available for the query

Example Request

Example Response

Error Responses

Returns when the API key is missing, invalid, or incorrect.
Returns when the specified company_slugdoes not exist in the database.
  • The company does not exist or has been deleted.
  • There’s a typo in the company_slugvalue.
  • The slug is incorrectly cased (e.g., uppercase vs lowercase letters).
Returns when an unexpected error occurs on the server.
  • Occurs during unhandled server-side failures or bugs that prevent the request from being processed.

Get a Single Company Job by Slug

Resolve a company_slug + job_slug deep-link back to the full job record. This is what powers the SDK’s neural_search(company_slug=..., job_slug=...) “similar jobs” convenience.

Endpoint

Authentication

x-api-key
string
Your Hirebase API key. Optional — not enforced on this endpoint today (like the other company GET endpoints).

Path Parameters

company_slug
string
required
URL-friendly identifier for the company.
job_slug
string
required
URL-friendly identifier for the job.

Response

jobs
array
Array containing the matching job(s) for the slug. Each entry uses the same job object shape as the Get Company Jobs response above.

Example Request

Example Response