Export Expired Jobs

curl --request POST \
  --url https://api.hirebase.org/v2/jobs/expired-jobs/export \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "since": "<string>",
  "notify": true
}
'

import requests

url = "https://api.hirebase.org/v2/jobs/expired-jobs/export"

payload = {
    "since": "<string>",
    "notify": True
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({since: '<string>', notify: true})
};

fetch('https://api.hirebase.org/v2/jobs/expired-jobs/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hirebase.org/v2/jobs/expired-jobs/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'since' => '<string>',
    'notify' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hirebase.org/v2/jobs/expired-jobs/export"

	payload := strings.NewReader("{\n  \"since\": \"<string>\",\n  \"notify\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hirebase.org/v2/jobs/expired-jobs/export")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"since\": \"<string>\",\n  \"notify\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/expired-jobs/export")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"since\": \"<string>\",\n  \"notify\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "10411d18-aa49-4253-bcad-b0f604f092be",
  "type": "export_expired_jobs",
  "state": "queued",
  "progress": 0.0,
  "input": { "since": "2026-08-15T00:00:00Z", "format": "jsonl" },
  "result": null,
  "error": null
}

{"_id": "6a7a7813250256b98912a4b2", "company_slug": "at-home", "job_slug": "zone-lead-ft-2a147c98", "date_expired": "2026-08-25"}

POST

jobs

expired-jobs

export

Export Expired Jobs

curl --request POST \
  --url https://api.hirebase.org/v2/jobs/expired-jobs/export \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "since": "<string>",
  "notify": true
}
'

import requests

url = "https://api.hirebase.org/v2/jobs/expired-jobs/export"

payload = {
    "since": "<string>",
    "notify": True
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({since: '<string>', notify: true})
};

fetch('https://api.hirebase.org/v2/jobs/expired-jobs/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hirebase.org/v2/jobs/expired-jobs/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'since' => '<string>',
    'notify' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hirebase.org/v2/jobs/expired-jobs/export"

	payload := strings.NewReader("{\n  \"since\": \"<string>\",\n  \"notify\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hirebase.org/v2/jobs/expired-jobs/export")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"since\": \"<string>\",\n  \"notify\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/expired-jobs/export")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"since\": \"<string>\",\n  \"notify\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "10411d18-aa49-4253-bcad-b0f604f092be",
  "type": "export_expired_jobs",
  "state": "queued",
  "progress": 0.0,
  "input": { "since": "2026-08-15T00:00:00Z", "format": "jsonl" },
  "result": null,
  "error": null
}

{"_id": "6a7a7813250256b98912a4b2", "company_slug": "at-home", "job_slug": "zone-lead-ft-2a147c98", "date_expired": "2026-08-25"}

Export the full expired-jobs feed since a given date as a downloadable JSONL file. This endpoint creates an async task and returns immediately; poll Get Task Status for the download URL.

This is the intended path for large historical pulls. The Expired Jobs feed is subject to deep-pagination limits (only roughly the most recent 350–450k records of a window are reachable page-by-page). The export walks the entire result set server-side with no page-depth limit — a one-week window of ~1M records exports completely.

This endpoint requires an API key for all requests. See Authentication.

Endpoint

POST /v2/jobs/expired-jobs/export

Authentication

string

required

Your Hirebase API key

Request Body

string

required

Starting date/datetime to export expired jobs from. Accepts ISO 8601 date ("2026-08-15") or full datetime ("2026-08-15T14:00:00Z"). Naive datetimes are treated as UTC. Invalid values return 400 with a descriptive message; a missing since returns 422.

boolean

default:"false"

Set to true to receive an email at your account address when the export completes, containing the download link.

There is no format field — expired-jobs exports are always JSONL (one JSON object per line).

Metering

Expired-jobs exports are free: they cost 0 units of your Jobs API allowance (m_jobs_api_calls), regardless of how many records they export. Expired data is not billed; only live job data is.

Response

Returns a task object (type: "export_expired_jobs", initial state: "queued"). Poll GET /v2/tasks/{task_id}; when state is "finished", result contains:

object

Show child attributes

string

URL to download the JSONL file

integer

File size in bytes

integer

Number of expired-job records exported

string

ISO timestamp when the download URL expires (30 days after completion)

Exported Record Fields

Each JSONL line contains exactly:

_id — unique job identifier; use it as job_id in GET /v2/jobs/{job_id}
company_slug
job_slug
date_expired (YYYY-MM-DD)

Example

curl -X POST 'https://api.hirebase.org/v2/jobs/expired-jobs/export' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"since": "2026-08-15T00:00:00Z", "notify": true}'

import requests, time

headers = {"x-api-key": "YOUR_API_KEY"}
task = requests.post(
    "https://api.hirebase.org/v2/jobs/expired-jobs/export",
    headers=headers,
    json={"since": "2026-08-15T00:00:00Z", "notify": True},
).json()

while True:
    t = requests.get(f"https://api.hirebase.org/v2/tasks/{task['id']}", headers=headers).json()
    if t["state"] in ("finished", "failed"):
        break
    time.sleep(5)

if t["state"] == "finished":
    jsonl = requests.get(t["result"]["download_url"]).text
    records = [line for line in jsonl.splitlines() if line]
    print(len(records), "expired jobs")

{
  "id": "10411d18-aa49-4253-bcad-b0f604f092be",
  "type": "export_expired_jobs",
  "state": "queued",
  "progress": 0.0,
  "input": { "since": "2026-08-15T00:00:00Z", "format": "jsonl" },
  "result": null,
  "error": null
}

{"_id": "6a7a7813250256b98912a4b2", "company_slug": "at-home", "job_slug": "zone-lead-ft-2a147c98", "date_expired": "2026-08-25"}

Jobs API

Expired Jobs API

Hiring Manager API

Companies API

Insights API

Salary Benchmark API

Reference Data API

Resumes

Tasks API

Billing & Usage

Error Handling

Export Expired Jobs

Endpoint

Authentication

Request Body

Metering

Response

Exported Record Fields

Example

​Endpoint

​Authentication

​Request Body

​Metering

​Response

​Exported Record Fields

​Example

Endpoint

Authentication

Request Body

Metering

Response

Exported Record Fields

Example