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>",
  "limit": 123,
  "notify": true
}
'

import requests

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

payload = {
    "since": "<string>",
    "limit": 123,
    "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>', limit: 123, 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>',
    'limit' => 123,
    '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  \"limit\": 123,\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  \"limit\": 123,\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  \"limit\": 123,\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-09-17T00:00:00Z", "format": "jsonl" },
  "result": null,
  "error": null
}

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

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>",
  "limit": 123,
  "notify": true
}
'

import requests

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

payload = {
    "since": "<string>",
    "limit": 123,
    "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>', limit: 123, 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>',
    'limit' => 123,
    '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  \"limit\": 123,\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  \"limit\": 123,\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  \"limit\": 123,\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-09-17T00:00:00Z", "format": "jsonl" },
  "result": null,
  "error": null
}

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

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 expiration syncs. It is built for job boards and other large mirrors that would rather receive one file of everything that expired since a date than page through the Expired Jobs feed. It is also the way to catch up after missed syncs. Like the feed, since can be at most 14 days ago; a one-week window of ~1M records exports completely.Like the feed, the export contains identifiers only (_id, company_slug, job_slug, date_expired). For full past postings, use the Historical Jobs endpoints.

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 ("YYYY-MM-DD") or full datetime ("YYYY-MM-DDTHH:MM:SSZ"). Naive datetimes are treated as UTC. Must be within the last 14 days (on or after midnight UTC 14 days ago). Invalid or older values return 400 with a descriptive message; a missing since returns 422.

integer

Maximum number of expired-job records to export (minimum 1). Omit it to export every match since since — unlike Export Jobs, there is no default of 10 here. Set it when you want a bounded file.

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

# Replace YYYY-MM-DD with a date in the last 14 days (UTC)
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": "YYYY-MM-DDT00:00:00Z", "limit": 100000, "notify": true}'

import requests, time
from datetime import datetime, timedelta, timezone

headers = {"x-api-key": "YOUR_API_KEY"}
since = (datetime.now(timezone.utc) - timedelta(days=7)).strftime("%Y-%m-%dT00:00:00Z")
task = requests.post(
    "https://api.hirebase.org/v2/jobs/expired-jobs/export",
    headers=headers,
    json={"since": since, "limit": 100000, "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-09-17T00:00:00Z", "format": "jsonl" },
  "result": null,
  "error": null
}

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

Jobs API

Expired & Historical 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