Skip to main content
GET
/
v2
/
jobs
/
{job_id}
Get Job by ID
curl --request GET \
  --url https://api.hirebase.org/v2/jobs/{job_id}
{
  "_id": "<string>",
  "company_name": "<string>",
  "job_title": "<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": "<string>",
  "education_level": "<string>",
  "team": "<string>",
  "language": "<string>",
  "recruiter_agency": true,
  "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": 123,
  "meta_targetability": 123,
  "company_data": {
    "description_summary": "<string>",
    "linkedin_link": {},
    "size_range": {
      "min": 123,
      "max": 123
    },
    "industries": [
      "<string>"
    ],
    "subindustries": [
      "<string>"
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://www.hirebase.org/docs/llms.txt

Use this file to discover all available pages before exploring further.

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
​
description
string
Full job description
​
application_link
string
URL to apply for the job
​
job_type
string
Type of job (e.g., “Full Time”, “Part Time”, “Contract”)
​
location_type
string
Work arrangement (e.g., “Remote”)
​
salary_range
object
Salary information
​
yoe_range
object | null
Years of experience range. May be null when the listing does not specify a range.
​
requirements_summary
string
Brief summary of job requirements
​
visa_sponsored
boolean
Whether visa sponsorship is offered
​
locations
array
Job locations
​
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
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
Detected experience level (e.g., "Entry", "Junior", "Mid", "Senior", "Executive")
​
education_level
string
Level of education required for the job
​
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)
​
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–1) representing how attractive/unique this role is relative to peers.
​
flexibility_score
number
Score (0–1) reflecting remote/hybrid flexibility and work-life balance signals.
​
compensation_value_score
number
Score (0–1) reflecting salary competitiveness vs. role and geography.
​
benefits_score
number
Score (0–1) based on benefits quantity and quality mentioned in the listing.
​
impact_autonomy_score
number
Score (0–1) for role-level autonomy and scope of impact.
​
prestige_score
number
Score (0–1) reflecting company and role prestige signals.
​
growth_score
number
Score (0–1) reflecting career growth and learning opportunities.
​
meta_completeness
number
Score (0–1) indicating how complete the parsed listing metadata is.
​
meta_targetability
number
Score (0–1) indicating how targetable/matchable the listing is for semantic search.
​
company_data
object
Enriched company profile details

​
Example Request

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

​
Example Response

{
    "_id": "67d550e407a47816d9b14f42",
    "company_name": "CompanyXYZ",
    "job_title": "Senior Backend Engineer (Python)",
    "description": "<p>We are seeking a highly skilled and experienced Senior Backend Engineer proficient in Python to join our dynamic and innovative engineering team.</p><h2>Requirements</h2><ul><li>Bachelor’s or higher degree in Computer Science, Software Engineering, or a related field.</li><li>Minimum of 3 years of proven experience as a Backend Engineer with expertise in Python development.</li><li>Demonstrated ability to design and implement scalable and maintainable systems.</li><li>Excellent problem-solving and debugging skills.</li><li>Effective communication and collaboration skills.</li></ul><h2>Benefits</h2><ul><li>Be part of a dynamic team that values innovation and fosters creativity.</li><li>Work on projects that contribute to shaping the future of the encryption market.</li><li>Opportunity for growth and skill development within a forward-thinking company.</li><li>Competitive salary and benefits package.</li></ul>",
    "application_link": "https://jobs.workable.com/view/kEaoFLFZs317RE9B8cZLtj/senior-backend-engineer-(python)-in-bulverde-at-companyxyz",
    "job_type": "Full Time",
    "location_type": "In-Person",
    "date_posted": "2023-12-07",
    "company_link": "https://www.companyxyz.com/",
    "company_logo": "https://workablehr.s3.amazonaws.com/uploads/account/logo/535415/logo",
    "job_board": "Workable",
    "job_board_link": "https://jobs.workable.com/company/mkC1FVMudAyt2jHWgCqc9z/jobs-at-companyxyz",
    "requirements_summary": "3+ years of experience, Bachelor's degree, expertise in Python and system design",
    "visa_sponsored": false,
    "company_data": {
        "description_summary": "CompanyXYZ is a global leader in secure and compliant data encryption hardware and solutions.",
        "linkedin_link": "https://www.linkedin.com/company/companyxyz",
        "size_range": {
            "min": 51,
            "max": 200
        },
        "industries": [
            "Tech, Software & IT Services"
        ],
        "subindustries": [
            "Hardware & Equipment",
            "Data Management & Analytics"
        ]
    },
    "job_slug": "senior-backend-engineer-python-15",
    "company_slug": "companyxyz",
    "locations": [
        {
            "city": "Bulverde",
            "region": "Texas",
            "country": "United States"
        }
    ],
    "job_categories": [
        "Engineering Jobs"
    ],
    "location_raw": "Bulverde, Texas, United States",
    "expired": false,
    "salary_range": null,
    "yoe_range": {
        "min": 3.0,
        "max": 3.0
    }
}

​
Error Responses

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.
Returns when the provided job_idis not in a valid MongoDB ObjectId format.
Make sure the ID is a 24-character hexadecimal string.