Skip to main content
GET
https://api.hirempire.com
/
v1
/
get-job
curl --location --request GET 'https://api.hirempire.com/v1/get-job?job_id={job_id}' \
--header 'Authorization: Bearer YOUR_TOKEN'
{
    "success": true,
    "job": [
        {
            "id": "tskxb758re93mmdv8g",
            "created_time": "2025-08-23T12:40:08.000Z",
            "job_title": "Marketing Manager",
            "company_name": "Hirempire",
            "job_type": "Full-time",
            "workplace_type": "Remote",
            "salary": "500000",
            "currency": "USD",
            "salary_period": "Per year",
            "is_salary_hidden": false,
            "career_level": "Mid-level",
            "job_location": "Egypt",
            "status": "Active",
            "applicants": 13,
            "job_description": "Job Description",
            "sources": {
                "count": 2,
                "items": [
                    { "source_name": "LinkedIn", "source_url": "https://hirempire.com/job-application?recordid=recdJKwSWQWFfs" },
                    { "source_name": "Referral", "source_url": "https://hirempire.com/job-application?recordid=recAEQ9l1Q7kVN" }
                ]
            }
        }
    ]
}

Parameters

job_id
string
required
The job ID to retrieve

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/get-job?job_id={job_id}' \
--header 'Authorization: Bearer YOUR_TOKEN'

Response

success
boolean
Indicates if the request was successful
job
array
Array containing the requested job object
{
    "success": true,
    "job": [
        {
            "id": "tskxb758re93mmdv8g",
            "created_time": "2025-08-23T12:40:08.000Z",
            "job_title": "Marketing Manager",
            "company_name": "Hirempire",
            "job_type": "Full-time",
            "workplace_type": "Remote",
            "salary": "500000",
            "currency": "USD",
            "salary_period": "Per year",
            "is_salary_hidden": false,
            "career_level": "Mid-level",
            "job_location": "Egypt",
            "status": "Active",
            "applicants": 13,
            "job_description": "Job Description",
            "sources": {
                "count": 2,
                "items": [
                    { "source_name": "LinkedIn", "source_url": "https://hirempire.com/job-application?recordid=recdJKwSWQWFfs" },
                    { "source_name": "Referral", "source_url": "https://hirempire.com/job-application?recordid=recAEQ9l1Q7kVN" }
                ]
            }
        }
    ]
}

Error Responses

400 Bad Request

{
    "success": false,
    "error": "Only 'job_id' is allowed in query parameters."
}
{
    "success": false,
    "error": "Invalid token"
}
{
    "success": false,
    "error": "Not found. This job has been deleted."
}

401 Unauthorized

{
    "success": false,
    "error": "Token is expired"
}
{
    "success": false,
    "error": "Token is missing required scope 'Jobs'"
}
{
    "success": false,
    "error": "Unauthorized. You don't have the permission to access this job."
}

403 Forbidden

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

404 Not Found

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