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_details": {
    "logo_url": "<string>",
    "company_size": "<string>",
    "industry": "<string>",
    "company_url": "<string>"
  },
  "skills": [
    {}
  ],
  "benefits": [
    {}
  ]
}
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”)
​
location_type
string
Work arrangement (e.g., “Remote”)
​
salary_range
object
Salary information
​
yoe_range
object
Years of experience 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)
​
job_slug
string
A unique identifier for the job, typically used in URLs.
​
company_slug
string
A unique identifier for the company, typically used in URLs.
​
company_details
object
Additional company information
​
skills
array
List of required skills
​
benefits
array
List of job benefits

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