Get Job by ID

curl --request GET \
  --url https://api.hirebase.org/v2/jobs/{job_id}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hirebase.org/v2/jobs/{job_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hirebase.org/v2/jobs/{job_id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/{job_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "_id": "<string>",
  "company_name": "<string>",
  "job_title": "<string>",
  "job_title_raw": "<string>",
  "description": "<string>",
  "application_link": "<string>",
  "job_type": "<string>",
  "location_type": "<string>",
  "salary_range": {
    "min": 123,
    "max": 123,
    "currency": "<string>",
    "period": "<string>"
  },
  "yoe_range": {
    "min": 123,
    "max": 123
  },
  "requirements_summary": "<string>",
  "visa_sponsored": true,
  "locations": [
    {
      "city": "<string>",
      "region": "<string>",
      "country": "<string>"
    }
  ],
  "expired": true,
  "date_posted": "<string>",
  "job_slug": "<string>",
  "company_slug": "<string>",
  "company_link": "<string>",
  "company_logo": "<string>",
  "job_board": "<string>",
  "job_board_link": "<string>",
  "job_categories": [
    "<string>"
  ],
  "experience_level": {},
  "education_level": "<string>",
  "team": "<string>",
  "language": "<string>",
  "recruiter_agency": true,
  "offers_equity": true,
  "md5_hash": "<string>",
  "platform_job_id": "<string>",
  "location_raw": "<string>",
  "description_raw": "<string>",
  "skills": [
    "<string>"
  ],
  "technologies": [
    "<string>"
  ],
  "benefits": [
    "<string>"
  ],
  "contact_email": {},
  "contact_phone": {},
  "coolness_score": 123,
  "flexibility_score": 123,
  "compensation_value_score": 123,
  "benefits_score": 123,
  "impact_autonomy_score": 123,
  "prestige_score": 123,
  "growth_score": 123,
  "meta_completeness": true,
  "meta_targetability": 123,
  "company_data": {
    "description_summary": "<string>",
    "linkedin_link": {},
    "services": [
      "<string>"
    ],
    "size_range": {
      "min": 123,
      "max": 123
    },
    "industries": [
      "<string>"
    ],
    "subindustries": [
      "<string>"
    ],
    "type": {},
    "is_recruiting_agency": {},
    "is_3rd_party_agency": {}
  }
}

GET

jobs

{job_id}

Get Job by ID

curl --request GET \
  --url https://api.hirebase.org/v2/jobs/{job_id}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hirebase.org/v2/jobs/{job_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hirebase.org/v2/jobs/{job_id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/{job_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "_id": "<string>",
  "company_name": "<string>",
  "job_title": "<string>",
  "job_title_raw": "<string>",
  "description": "<string>",
  "application_link": "<string>",
  "job_type": "<string>",
  "location_type": "<string>",
  "salary_range": {
    "min": 123,
    "max": 123,
    "currency": "<string>",
    "period": "<string>"
  },
  "yoe_range": {
    "min": 123,
    "max": 123
  },
  "requirements_summary": "<string>",
  "visa_sponsored": true,
  "locations": [
    {
      "city": "<string>",
      "region": "<string>",
      "country": "<string>"
    }
  ],
  "expired": true,
  "date_posted": "<string>",
  "job_slug": "<string>",
  "company_slug": "<string>",
  "company_link": "<string>",
  "company_logo": "<string>",
  "job_board": "<string>",
  "job_board_link": "<string>",
  "job_categories": [
    "<string>"
  ],
  "experience_level": {},
  "education_level": "<string>",
  "team": "<string>",
  "language": "<string>",
  "recruiter_agency": true,
  "offers_equity": true,
  "md5_hash": "<string>",
  "platform_job_id": "<string>",
  "location_raw": "<string>",
  "description_raw": "<string>",
  "skills": [
    "<string>"
  ],
  "technologies": [
    "<string>"
  ],
  "benefits": [
    "<string>"
  ],
  "contact_email": {},
  "contact_phone": {},
  "coolness_score": 123,
  "flexibility_score": 123,
  "compensation_value_score": 123,
  "benefits_score": 123,
  "impact_autonomy_score": 123,
  "prestige_score": 123,
  "growth_score": 123,
  "meta_completeness": true,
  "meta_targetability": 123,
  "company_data": {
    "description_summary": "<string>",
    "linkedin_link": {},
    "services": [
      "<string>"
    ],
    "size_range": {
      "min": 123,
      "max": 123
    },
    "industries": [
      "<string>"
    ],
    "subindustries": [
      "<string>"
    ],
    "type": {},
    "is_recruiting_agency": {},
    "is_3rd_party_agency": {}
  }
}

Get complete details for a specific job by providing thejob_id. This includes information such as job title, employment type, company details, salary range, location data, etc. Using this endpoint, you can display information of an individual job in detail.

Endpoint

GET /v2/jobs/{job_id}

Path Parameters

string

required

The job’s MongoDB ObjectId

Response

string

Unique job identifier

string

Name of the company

string

Title of the job

string

Unparsed job title as scraped from the source.

string

Full job description

string

URL to apply for the job

string

Employment type. One of: "Full Time", "Part Time", "Contract / Temporary", "Internship".

string

Work arrangement (e.g., “Remote”)

object

Salary information

Show child attributes

number

Minimum salary

number

Maximum salary

string

Currency code (e.g., “USD”)

string

Pay period for the salary range. Observed values: "yearly", "monthly", "daily", "hourly".

This field is not fully normalized today — you may also see "year" (≡ "yearly") and "hour" (≡ "hourly"). Treat those as equivalent until normalized.

object | null

Years of experience range. May be null when the listing does not specify a range.

Show child attributes

number

Minimum years of experience

number

Maximum years of experience

string

Brief summary of job requirements

boolean

Whether visa sponsorship is offered

array

Job locations

Show child attributes

string

City name

string

State/province/region

string

Country name

boolean

Shows whether the job listing is still active or no longer available

string

Date when the job was posted (ISO format YYYY-MM-DD)

string

A unique URL-friendly identifier for the job

string

A unique URL-friendly identifier for the company

string

Name of the hiring company

string

Official company website URL

string

URL to the company’s logo image

string

Source job board name (e.g., "iCIMS", "Workable", "Greenhouse")

string

URL of the job board hosting the listing

string[]

Categories or tags associated with the job posting

string | null

Parsed experience tier for the role. Response values: "Entry-Level", "Junior / Associate", "Mid-Level", "Senior", "Principal / Staff / Lead", "Executive". May be null when not inferred.

string

Required education level. One of: "No Education Required", "High school degree", "Associate degree", "Bachelor's degree", "Master's degree", "Doctoral degree".

string

Team at the company hiring for the position

string

Language the job posting is written in

boolean

Indicates whether the listing was posted by a recruiting agency (not the hiring company directly)

boolean

Whether the listing mentions equity compensation.

string

Content hash of the listing.

string

The source ATS’s own job identifier.

string

Raw, unparsed location string as it appeared on the source job board

string

Raw HTML description as scraped from the job board (before any cleaning/normalization)

string[]

List of skills detected in the job description

string[]

List of technologies mentioned in the job description

string[]

List of benefits mentioned in the job description

string | null

Contact email for the listing, when available. Paid users only.

string | null

Contact phone number for the listing, when available. Paid users only.

number

Composite score (0–10) representing how attractive/unique this role is relative to peers.

number

Score (0–10) reflecting remote/hybrid flexibility and work-life balance signals.

number

Score (0–10) reflecting salary competitiveness vs. role and geography.

number

Score (0–10) based on benefits quantity and quality mentioned in the listing.

number

Score (0–10) for role-level autonomy and scope of impact.

number

Score (0–10) reflecting company and role prestige signals.

number

Score (0–10) reflecting career growth and learning opportunities.

boolean

Whether the parsed listing metadata is considered complete.

number

Internal signal (0–1) reflecting how targetable/complete the listing is for matching.

object

Enriched company profile details

Show child attributes

string

Short description about the company’s mission or services

string | null

Link to the company’s LinkedIn profile

string[]

List of services that the company provides

object | null

Approximate number of employees

Show child attributes

number

Minimum number of employees

number

Maximum number of employees

string[]

High-level industry tags

string[]

More specific industry categories

string | null

Categorical company type (e.g., "Startup", "Enterprise").

boolean | null

Whether the company is a recruiting/talent agency.

boolean | null

Whether the company is a third-party agency.

Example Request

curl -X GET "https://api.hirebase.org/v2/jobs/67d550e407a47816d9b14f42" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY"

const getJob = async (jobId) => {
  const response = await fetch(`https://api.hirebase.org/v2/jobs/${jobId}`, {
    method: 'GET',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
  });
  
  const data = await response.json();
  return data;
};

// Example usage
getJob('67d550e407a47816d9b14f42');

import requests

job_id = "67d550e407a47816d9b14f42"
url = "https://api.hirebase.org/v2/jobs/{job_id}"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
data = response.json()
print(data)

Example Response

{
    "_id": "67d550e407a47816d9b14f42",
    "company_name": "CompanyXYZ",
    "job_title": "Senior Python Engineer",
    "job_title_raw": "Senior Python Engineer - Remote",
    "description": "<p>… cleaned/summarized description …</p>",
    "description_raw": "<p>… full original HTML description from the ATS source …</p>",
    "application_link": "https://jobs.workable.com/view/nqSdYtJwQ/...",
    "job_categories": ["Software Engineer Jobs", "Engineering Jobs", "Information Technology Jobs"],
    "job_type": "Full Time",
    "location_type": "Remote",
    "location_raw": "TELECOMMUTE; British Columbia, Canada",
    "locations": [
        {
            "city": null,
            "region": null,
            "country": "Canada",
            "coordinates": {"type": "Point", "coordinates": [-123.12, 49.28]},
            "bbox": [-123.2, 49.0, -122.9, 49.3],
            "address": "British Columbia, Canada"
        }
    ],
    "salary_range": {"min": 150000, "max": 210000, "currency": "USD", "period": "yearly"},
    "yoe_range": {"min": 2, "max": 5},
    "experience_level": "Senior",
    "education_level": "Bachelor's degree",
    "skills": ["Python", "FastAPI", "Distributed systems"],
    "technologies": ["Python", "PostgreSQL", "AWS"],
    "benefits": ["401k matching", "Remote-first", "Equity"],
    "requirements_summary": "5+ years Python; distributed systems experience",
    "team": "Platform Engineering",
    "language": "en",
    "visa_sponsored": false,
    "recruiter_agency": false,
    "offers_equity": false,
    "expired": false,
    "date_posted": "2026-06-07",
    "job_board": "workable",
    "job_board_link": "https://jobs.workable.com/company/...",
    "job_slug": "senior-python-engineer-17",
    "company_slug": "companyxyz",
    "company_link": "companyxyz.com",
    "company_logo": "https://logos.hirebase.org/.../companyxyz-320x320-q95.jpg",
    "md5_hash": "d6b5d4e7b99d23b082b46e49c22c168f",
    "platform_job_id": "ad88b6ba-a905-4850-ad79-73beb0e97766",
    "contact_email": "careers@companyxyz.com",
    "contact_phone": "+1-415-555-0142",
    "coolness_score": 6.4,
    "flexibility_score": 6.1,
    "compensation_value_score": 6.0,
    "benefits_score": 5.0,
    "impact_autonomy_score": 7.1,
    "prestige_score": 5.2,
    "growth_score": 6.2,
    "meta_completeness": false,
    "meta_targetability": 0.8,
    "company_data": {
        "description_summary": "CompanyXYZ builds …",
        "linkedin_link": "https://www.linkedin.com/company/companyxyz",
        "size_range": {"min": 51, "max": 200},
        "industries": ["Tech, Software & IT Services"],
        "subindustries": ["AI & ML"],
        "services": ["Platform", "APIs"],
        "type": "Startup",
        "is_recruiting_agency": false,
        "is_3rd_party_agency": false
    }
}

Error Responses

404 Not Found

Returns when the specified job_id does not exist in the database.
This may occur if the job was deleted or the ID is incorrect. A well-formed 24-character hex ObjectId that does not match any job returns 404.

500 Internal Server Error

Returns when job_id is not a valid MongoDB ObjectId (e.g. wrong length or non-hex characters).
Valid ObjectIds are 24-character hexadecimal strings. Until this is changed to return 422, malformed IDs surface as 500 with a message like '…' is not a valid ObjectId.

Jobs API

Expired Jobs API

Hiring Manager API

Companies API

Insights API

Salary Benchmark API

Reference Data API

Resumes

Tasks API

Billing & Usage

Error Handling

Get Job by ID

Endpoint

Path Parameters

Response

Example Request

Example Response

Error Responses

​Endpoint

​Path Parameters

​Response

​Example Request

​Example Response

​Error Responses

Endpoint

Path Parameters

Response

Example Request

Example Response

Error Responses