curl --location --request GET 'https://api.hirempire.com/v1/get-job?job_id={job_id}' \
--header 'Authorization: Bearer YOUR_TOKEN'
const response = await fetch('https://api.hirempire.com/v1/get-job?job_id={job_id}', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
});
const data = await response.json();
console.log(data);
import requests
url = "https://api.hirempire.com/v1/get-job"
params = {
"job_id": "{job_id}"
}
headers = {
"Authorization": "Bearer YOUR_TOKEN"
}
response = requests.get(url, params=params, headers=headers)
data = response.json()
print(data)
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.hirempire.com/v1/get-job?job_id={job_id}',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer YOUR_TOKEN'
),
));
$response = curl_exec($curl);
curl_close($curl);
$data = json_decode($response, true);
print_r($data);
?>
require 'net/http'
require 'json'
require 'uri'
uri = URI('https://api.hirempire.com/v1/get-job')
uri.query = URI.encode_www_form({job_id: '{job_id}'})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_TOKEN'
response = http.request(request)
data = JSON.parse(response.body)
puts data
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL := "https://api.hirempire.com/v1/get-job"
params := url.Values{}
params.Add("job_id", "{job_id}")
client := &http.Client{}
req, _ := http.NewRequest("GET", baseURL+"?"+params.Encode(), nil)
req.Header.Add("Authorization", "Bearer YOUR_TOKEN")
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
public class HirempireAPI {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.hirempire.com/v1/get-job?job_id={job_id}"))
.header("Authorization", "Bearer YOUR_TOKEN")
.GET()
.build();
HttpResponse<String> response = client.send(request,
HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
private static readonly HttpClient client = new HttpClient();
static async Task Main(string[] args)
{
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_TOKEN");
HttpResponseMessage response = await client.GetAsync("https://api.hirempire.com/v1/get-job?job_id={job_id}");
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseBody);
}
}
import Foundation
var components = URLComponents(string: "https://api.hirempire.com/v1/get-job")!
components.queryItems = [URLQueryItem(name: "job_id", value: "{job_id}")]
var request = URLRequest(url: components.url!)
request.setValue("Bearer YOUR_TOKEN", forHTTPHeaderField: "Authorization")
let task = URLSession.shared.dataTask(with: request) { data, response, error in
if let data = data {
let json = try? JSONSerialization.jsonObject(with: data)
print(json ?? "No data")
}
}
task.resume()
import kotlinx.coroutines.*
import java.net.http.HttpClient
import java.net.http.HttpRequest
import java.net.http.HttpResponse
import java.net.URI
fun main() = runBlocking {
val client = HttpClient.newHttpClient()
val request = HttpRequest.newBuilder()
.uri(URI.create("https://api.hirempire.com/v1/get-job?job_id={job_id}"))
.header("Authorization", "Bearer YOUR_TOKEN")
.GET()
.build()
val response = client.send(request, HttpResponse.BodyHandlers.ofString())
println(response.body())
}
use reqwest::header::{HeaderMap, HeaderValue, AUTHORIZATION};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let mut headers = HeaderMap::new();
headers.insert(AUTHORIZATION, HeaderValue::from_str("Bearer YOUR_TOKEN")?);
let client = reqwest::Client::new();
let response = client
.get("https://api.hirempire.com/v1/get-job")
.query(&[("job_id", "{job_id}")])
.headers(headers)
.send()
.await?;
let body = response.text().await?;
println!("{}", body);
Ok(())
}
{
"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" }
]
}
}
}
Jobs
Get a specific job
Retrieve a specific job by job ID from your Hirempire account
GET
/
v1
/
get-job
curl --location --request GET 'https://api.hirempire.com/v1/get-job?job_id={job_id}' \
--header 'Authorization: Bearer YOUR_TOKEN'
const response = await fetch('https://api.hirempire.com/v1/get-job?job_id={job_id}', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
});
const data = await response.json();
console.log(data);
import requests
url = "https://api.hirempire.com/v1/get-job"
params = {
"job_id": "{job_id}"
}
headers = {
"Authorization": "Bearer YOUR_TOKEN"
}
response = requests.get(url, params=params, headers=headers)
data = response.json()
print(data)
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.hirempire.com/v1/get-job?job_id={job_id}',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer YOUR_TOKEN'
),
));
$response = curl_exec($curl);
curl_close($curl);
$data = json_decode($response, true);
print_r($data);
?>
require 'net/http'
require 'json'
require 'uri'
uri = URI('https://api.hirempire.com/v1/get-job')
uri.query = URI.encode_www_form({job_id: '{job_id}'})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_TOKEN'
response = http.request(request)
data = JSON.parse(response.body)
puts data
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL := "https://api.hirempire.com/v1/get-job"
params := url.Values{}
params.Add("job_id", "{job_id}")
client := &http.Client{}
req, _ := http.NewRequest("GET", baseURL+"?"+params.Encode(), nil)
req.Header.Add("Authorization", "Bearer YOUR_TOKEN")
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
public class HirempireAPI {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.hirempire.com/v1/get-job?job_id={job_id}"))
.header("Authorization", "Bearer YOUR_TOKEN")
.GET()
.build();
HttpResponse<String> response = client.send(request,
HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
private static readonly HttpClient client = new HttpClient();
static async Task Main(string[] args)
{
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_TOKEN");
HttpResponseMessage response = await client.GetAsync("https://api.hirempire.com/v1/get-job?job_id={job_id}");
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseBody);
}
}
import Foundation
var components = URLComponents(string: "https://api.hirempire.com/v1/get-job")!
components.queryItems = [URLQueryItem(name: "job_id", value: "{job_id}")]
var request = URLRequest(url: components.url!)
request.setValue("Bearer YOUR_TOKEN", forHTTPHeaderField: "Authorization")
let task = URLSession.shared.dataTask(with: request) { data, response, error in
if let data = data {
let json = try? JSONSerialization.jsonObject(with: data)
print(json ?? "No data")
}
}
task.resume()
import kotlinx.coroutines.*
import java.net.http.HttpClient
import java.net.http.HttpRequest
import java.net.http.HttpResponse
import java.net.URI
fun main() = runBlocking {
val client = HttpClient.newHttpClient()
val request = HttpRequest.newBuilder()
.uri(URI.create("https://api.hirempire.com/v1/get-job?job_id={job_id}"))
.header("Authorization", "Bearer YOUR_TOKEN")
.GET()
.build()
val response = client.send(request, HttpResponse.BodyHandlers.ofString())
println(response.body())
}
use reqwest::header::{HeaderMap, HeaderValue, AUTHORIZATION};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let mut headers = HeaderMap::new();
headers.insert(AUTHORIZATION, HeaderValue::from_str("Bearer YOUR_TOKEN")?);
let client = reqwest::Client::new();
let response = client
.get("https://api.hirempire.com/v1/get-job")
.query(&[("job_id", "{job_id}")])
.headers(headers)
.send()
.await?;
let body = response.text().await?;
println!("{}", body);
Ok(())
}
{
"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
string
required
The job ID to retrieve
Authentication
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'
const response = await fetch('https://api.hirempire.com/v1/get-job?job_id={job_id}', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
});
const data = await response.json();
console.log(data);
import requests
url = "https://api.hirempire.com/v1/get-job"
params = {
"job_id": "{job_id}"
}
headers = {
"Authorization": "Bearer YOUR_TOKEN"
}
response = requests.get(url, params=params, headers=headers)
data = response.json()
print(data)
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.hirempire.com/v1/get-job?job_id={job_id}',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer YOUR_TOKEN'
),
));
$response = curl_exec($curl);
curl_close($curl);
$data = json_decode($response, true);
print_r($data);
?>
require 'net/http'
require 'json'
require 'uri'
uri = URI('https://api.hirempire.com/v1/get-job')
uri.query = URI.encode_www_form({job_id: '{job_id}'})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_TOKEN'
response = http.request(request)
data = JSON.parse(response.body)
puts data
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL := "https://api.hirempire.com/v1/get-job"
params := url.Values{}
params.Add("job_id", "{job_id}")
client := &http.Client{}
req, _ := http.NewRequest("GET", baseURL+"?"+params.Encode(), nil)
req.Header.Add("Authorization", "Bearer YOUR_TOKEN")
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
public class HirempireAPI {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.hirempire.com/v1/get-job?job_id={job_id}"))
.header("Authorization", "Bearer YOUR_TOKEN")
.GET()
.build();
HttpResponse<String> response = client.send(request,
HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
private static readonly HttpClient client = new HttpClient();
static async Task Main(string[] args)
{
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_TOKEN");
HttpResponseMessage response = await client.GetAsync("https://api.hirempire.com/v1/get-job?job_id={job_id}");
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseBody);
}
}
import Foundation
var components = URLComponents(string: "https://api.hirempire.com/v1/get-job")!
components.queryItems = [URLQueryItem(name: "job_id", value: "{job_id}")]
var request = URLRequest(url: components.url!)
request.setValue("Bearer YOUR_TOKEN", forHTTPHeaderField: "Authorization")
let task = URLSession.shared.dataTask(with: request) { data, response, error in
if let data = data {
let json = try? JSONSerialization.jsonObject(with: data)
print(json ?? "No data")
}
}
task.resume()
import kotlinx.coroutines.*
import java.net.http.HttpClient
import java.net.http.HttpRequest
import java.net.http.HttpResponse
import java.net.URI
fun main() = runBlocking {
val client = HttpClient.newHttpClient()
val request = HttpRequest.newBuilder()
.uri(URI.create("https://api.hirempire.com/v1/get-job?job_id={job_id}"))
.header("Authorization", "Bearer YOUR_TOKEN")
.GET()
.build()
val response = client.send(request, HttpResponse.BodyHandlers.ofString())
println(response.body())
}
use reqwest::header::{HeaderMap, HeaderValue, AUTHORIZATION};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let mut headers = HeaderMap::new();
headers.insert(AUTHORIZATION, HeaderValue::from_str("Bearer YOUR_TOKEN")?);
let client = reqwest::Client::new();
let response = client
.get("https://api.hirempire.com/v1/get-job")
.query(&[("job_id", "{job_id}")])
.headers(headers)
.send()
.await?;
let body = response.text().await?;
println!("{}", body);
Ok(())
}
Response
boolean
Indicates if the request was successful
object
The job object
Show Job object properties
Show Job object properties
string
Unique identifier for the job
string
ISO 8601 timestamp when the job was created
string
Title of the job position.
string
URL slug for the public job board page.
string
Name of the hiring company.
string
URL to the hiring company’s logo.
string
Department the job is in (e.g. Engineering).
string
Industry classification.
string
Career level. One of:
junior mid-level senior team-leader manager director vp c-level.string
Employment type. One of:
full-time part-time contract freelance internship temporary project-based.string
Work arrangement. One of:
onsite remote hybrid.string
Geographic location, formatted as
"City, Country". The city portion is omitted if not set.string
Computed salary display string.
null when confidential.string
One of:
fixed range confidential.number
Lower bound (range mode).
number
Upper bound (range mode).
number
Fixed salary (fixed mode).
string
ISO 4217 three-letter code (e.g.,
USD).string
One of:
Per hour Per day Per week Bi-weekly Per month Per year.boolean
true if the salary is hidden on the public board.string
Full description of the job requirements and responsibilities.
object
Application form configuration.
null if no custom questions are set up.Show questions structure
Show questions structure
object
Built-in toggles for standard application data. Each is a boolean:
show_cover_lettershow_photoshow_experience_yearsshow_languagesshow_nationalityshow_locationshow_salary_expectation
array
Array of per-job custom questions. Each item:
id(string) — question UUIDlabel(string) — the question texttype(string) — one of:texttextareanumberdateurlfilesingle_selectmulti_selectvideoaudiooptions(any) — for select types, the list of choices; otherwisenullrequired(boolean) — whether the candidate must answer
object
Source link tracking for the job.
Show sources structure
Show sources structure
string
Current status. One of:
draft active paused closed.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"
}
Was this page helpful?
⌘I