Skip to main content
GET
https://api.hirempire.com
/
v1
/
jobs
curl --location --request GET 'https://api.hirempire.com/v1/jobs' \
--header 'Authorization: Bearer YOUR_TOKEN'
{
  "success": true,
  "total_jobs": 2,
  "jobs": [
    {
      "id": "abc123xyz789",
      "created_time": "2025-02-20T10:00:00.000Z",
      "job_title": "Software Engineer",
      "job_type": "Full-time",
      "job_mode": "Remote",
      "job_location": "USA",
      "company_name": "TechCorp",
      "job_description": "We are looking for a talented Software Engineer to join our development team. Responsibilities include designing, developing, and maintaining software applications, collaborating with cross-functional teams, and ensuring high-quality code through testing and code reviews.",
      "status": "Active",
      "applicants": 5
    },
    {
      "id": "xyz456abc123",
      "created_time": "2025-02-18T15:30:00.000Z",
      "job_title": "Marketing Manager",
      "job_type": "Part-time",
      "job_mode": "Hybrid",
      "job_location": "UK",
      "company_name": "MarketGenius",
      "job_description": "The Marketing Manager will be responsible for developing and executing marketing campaigns, analyzing market trends, and working with internal teams to enhance brand visibility. The ideal candidate should have strong communication skills and experience in digital marketing strategies.",
      "status": "Paused",
      "applicants": 3
    }
  ]
}

Authentication

Authorization
string
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
curl --location --request GET 'https://api.hirempire.com/v1/jobs' \
--header 'Authorization: Bearer YOUR_TOKEN'

Response

success
boolean
Indicates if the request was successful
total_jobs
integer
Total number of jobs returned
jobs
array
Array of job objects
{
  "success": true,
  "total_jobs": 2,
  "jobs": [
    {
      "id": "abc123xyz789",
      "created_time": "2025-02-20T10:00:00.000Z",
      "job_title": "Software Engineer",
      "job_type": "Full-time",
      "job_mode": "Remote",
      "job_location": "USA",
      "company_name": "TechCorp",
      "job_description": "We are looking for a talented Software Engineer to join our development team. Responsibilities include designing, developing, and maintaining software applications, collaborating with cross-functional teams, and ensuring high-quality code through testing and code reviews.",
      "status": "Active",
      "applicants": 5
    },
    {
      "id": "xyz456abc123",
      "created_time": "2025-02-18T15:30:00.000Z",
      "job_title": "Marketing Manager",
      "job_type": "Part-time",
      "job_mode": "Hybrid",
      "job_location": "UK",
      "company_name": "MarketGenius",
      "job_description": "The Marketing Manager will be responsible for developing and executing marketing campaigns, analyzing market trends, and working with internal teams to enhance brand visibility. The ideal candidate should have strong communication skills and experience in digital marketing strategies.",
      "status": "Paused",
      "applicants": 3
    }
  ]
}

Error Responses

400 Bad Request

{
    "success": false,
    "error": "Request params are not allowed."
}
{
    "success": false,
    "error": "Invalid token"
}

401 Unauthorized

{
    "success": false,
    "error": "Token is expired"
}
{
    "success": false,
    "error": "Token is missing required scope 'Jobs'"
}

403 Forbidden

{
    "success": false,
    "error": "Token has been deleted"
}

404 Not Found

{
    "success": false,
    "error": "Job not found."
}