Get a specific job - Hirempire Docs

curl --location --request GET 'https://api.hirempire.com/v1/get-job?job_id={job_id}' \
--header 'Authorization: Bearer YOUR_TOKEN'

{
    "success": true,
    "job": {
        "id": "f3a2c1d4-1111-4222-9333-444455556666",
        "created_time": "2026-06-23T12:40:08.000Z",
        "job_title": "Marketing Manager",
        "company_name": "Hirempire",
        "job_type": "full-time",
        "job_mode": "remote",
        "salary": "500000",
        "currency": "USD",
        "salary_period": "Per year",
        "is_salary_hidden": false,
        "career_level": "mid-level",
        "job_location": "Cairo, Egypt",
        "status": "active",
        "applicants": 13,
        "job_description": "Job Description",
        "sources": {
            "count": 2,
            "items": [
                { "source_name": "LinkedIn" },
                { "source_name": "Referral" }
            ]
        }
    }
}

GET

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": "f3a2c1d4-1111-4222-9333-444455556666",
        "created_time": "2026-06-23T12:40:08.000Z",
        "job_title": "Marketing Manager",
        "company_name": "Hirempire",
        "job_type": "full-time",
        "job_mode": "remote",
        "salary": "500000",
        "currency": "USD",
        "salary_period": "Per year",
        "is_salary_hidden": false,
        "career_level": "mid-level",
        "job_location": "Cairo, Egypt",
        "status": "active",
        "applicants": 13,
        "job_description": "Job Description",
        "sources": {
            "count": 2,
            "items": [
                { "source_name": "LinkedIn" },
                { "source_name": "Referral" }
            ]
        }
    }
}

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

object

The job object

Show Job object properties

string

Unique identifier for the job

created_time

string

ISO 8601 timestamp when the job was created

job_title

string

Title of the job position.

public_slug

string

URL slug for the public job board page.

company_name

string

Name of the hiring company.

company_logo_url

string

URL to the hiring company’s logo.

department

string

Department the job is in (e.g. Engineering).

industry

string

Industry classification.

career_level

string

Career level. One of: junior mid-level senior team-leader manager director vp c-level.

job_type

string

Employment type. One of: full-time part-time contract freelance internship temporary project-based.

job_mode

string

Work arrangement. One of: onsite remote hybrid.

job_location

string

Geographic location, formatted as "City, Country". The city portion is omitted if not set.

salary

string

Computed salary display string. null when confidential.

salary_type

string

One of: fixed range confidential.

salary_min

number

Lower bound (range mode).

salary_max

number

Upper bound (range mode).

salary_fixed

number

Fixed salary (fixed mode).

currency

string

ISO 4217 three-letter code (e.g., USD).

salary_period

string

One of: Per hour Per day Per week Bi-weekly Per month Per year.

is_salary_hidden

boolean

true if the salary is hidden on the public board.

job_description

string

Full description of the job requirements and responsibilities.

questions

object

Application form configuration. null if no custom questions are set up.

Show questions structure

fields

object

Built-in toggles for standard application data. Each is a boolean:

show_cover_letter
show_photo
show_experience_years
show_languages
show_nationality
show_location
show_salary_expectation

custom

array

Array of per-job custom questions. Each item:

id (string) — question UUID
label (string) — the question text
type (string) — one of: text textarea number date url file single_select multi_select video audio
options (any) — for select types, the list of choices; otherwise null
required (boolean) — whether the candidate must answer

sources

object

Source link tracking for the job.

Show sources structure

count

integer

Number of source links.

items

array

Each item:

id (string) — source link UUID
source_name (string) — label like LinkedIn
source_url (string) — public tracking URL: https://jobs.hirempire.com/{company-slug}/{source-id}
visits (integer) — visits to that URL
created_at (string) — ISO 8601

status

string

Current status. One of: draft active paused closed.

applicants

integer

Number of applicants on this job.

{
    "success": true,
    "job": {
        "id": "f3a2c1d4-1111-4222-9333-444455556666",
        "created_time": "2026-06-23T12:40:08.000Z",
        "job_title": "Marketing Manager",
        "company_name": "Hirempire",
        "job_type": "full-time",
        "job_mode": "remote",
        "salary": "500000",
        "currency": "USD",
        "salary_period": "Per year",
        "is_salary_hidden": false,
        "career_level": "mid-level",
        "job_location": "Cairo, Egypt",
        "status": "active",
        "applicants": 13,
        "job_description": "Job Description",
        "sources": {
            "count": 2,
            "items": [
                { "source_name": "LinkedIn" },
                { "source_name": "Referral" }
            ]
        }
    }
}

Error Responses

400 Bad Request

{
    "success": false,
    "error": "Only 'job_id' query parameter is allowed."
}

401 Unauthorized

{
    "success": false,
    "error": "Invalid token"
}

{
    "success": false,
    "error": "Token is expired"
}

404 Not Found

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

Get all jobs Add a job

​Parameters

​Authentication

​Response

​Error Responses

​400 Bad Request

​401 Unauthorized

​404 Not Found

Parameters

Authentication

Response

Error Responses

400 Bad Request

401 Unauthorized

404 Not Found