Get Job by ID

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

import requests

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

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.hirebase.org/v2/jobs/{job_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?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))

}

HttpResponse<String> response = Unirest.get("https://api.hirebase.org/v2/jobs/{job_id}")
  .asString();

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}

import requests

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

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.hirebase.org/v2/jobs/{job_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?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))

}

HttpResponse<String> response = Unirest.get("https://api.hirebase.org/v2/jobs/{job_id}")
  .asString();

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

job_id

string

required

The job’s MongoDB ObjectId

Response

_id

string

Unique job identifier

company_name

string

Name of the company

job_title

string

Title of the job

job_title_raw

string

Unparsed job title as scraped from the source.

description

string

Full job description

application_link

string

URL to apply for the job

job_type

string

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

location_type

string

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

salary_range

object

Salary information

Show child attributes

min

number

Minimum salary

max

number

Maximum salary

currency

string

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

period

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.

yoe_range

object | null

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

Show child attributes

min

number

Minimum years of experience

max

number

Maximum years of experience

requirements_summary

string

Brief summary of job requirements

visa_sponsored

boolean

Whether visa sponsorship is offered

locations

array

Job locations

Show child attributes

city

string

City name

region

string

State/province/region

country

string

Country name

expired

boolean

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

date_posted

string

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

job_slug

string

A unique URL-friendly identifier for the job

company_slug

string

A unique URL-friendly identifier for the company

company_name

string

Name of the hiring company

company_link

string

Official company website URL

company_logo

string

URL to the company’s logo image

job_board

string

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

job_board_link

string

URL of the job board hosting the listing

job_categories

string[]

Categories or tags associated with the job posting

experience_level

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.

education_level

string

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

team

string

Team at the company hiring for the position

language

string

Language the job posting is written in

recruiter_agency

boolean

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

offers_equity

boolean

Whether the listing mentions equity compensation.

md5_hash

string

Content hash of the listing.

platform_job_id

string

The source ATS’s own job identifier.

location_raw

string

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

description_raw

string

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

skills

string[]

List of skills detected in the job description

technologies

string[]

List of technologies mentioned in the job description

benefits

string[]

List of benefits mentioned in the job description

contact_email

string | null

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

contact_phone

string | null

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

coolness_score

number

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

flexibility_score

number

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

compensation_value_score

number

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

benefits_score

number

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

impact_autonomy_score

number

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

prestige_score

number

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

growth_score

number

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

meta_completeness

boolean

Whether the parsed listing metadata is considered complete.

meta_targetability

number

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

company_data

object

Enriched company profile details

Show child attributes

description_summary

string

Short description about the company’s mission or services

linkedin_link

string | null

Link to the company’s LinkedIn profile

services

string[]

List of services that the company provides

size_range

object | null

Approximate number of employees

Show child attributes

min

number

Minimum number of employees

max

number

Maximum number of employees

industries

string[]

High-level industry tags

subindustries

string[]

More specific industry categories

type

string | null

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

is_recruiting_agency

boolean | null

Whether the company is a recruiting/talent agency.

is_3rd_party_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.

Expired Jobs

Hiring Manager Contacts API

Jobs API

Hiring Manager API

Companies API

Insights API

Reference Data API

Resumes

Tasks API

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