Expired Jobs

curl -X GET 'https://api.hirebase.org/v2/jobs/expired-jobs?since=2026-01-31&page=1&limit=100' \
  -H 'x-api-key: YOUR_API_KEY'

import requests

url = "https://api.hirebase.org/v2/jobs/expired-jobs"
headers = {
    "x-api-key": "YOUR_API_KEY"
}
params = {
    "since": "2026-01-31",
    "page": 1,
    "limit": 100
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

const url = 'https://api.hirebase.org/v2/jobs/expired-jobs?since=2026-01-31&page=1&limit=100';

const response = await fetch(url, {
  method: 'GET',
  headers: {
    'x-api-key': 'YOUR_API_KEY'
  }
});

const data = await response.json();

{
  "jobs": [
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2c",
      "company_slug": "rentokil-initial-group",
      "job_slug": "service-driver-2353c936",
      "date_expired": "2026-03-01"
    },
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2d",
      "company_slug": "phasor-engineering-inc",
      "job_slug": "commissioning-lead-commissioning-manager-field-based-2cfa04f9",
      "date_expired": "2026-03-01"
    },
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2e",
      "company_slug": "squaredev",
      "job_slug": "fullstack-engineer-88e05e56",
      "date_expired": "2026-03-01"
    },
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2f",
      "company_slug": "zoopla",
      "job_slug": "customer-success-consultant-12-months-ftc-47754cd9",
      "date_expired": "2026-03-01"
    }
  ],
  "total_count": 1247,
  "page": 1,
  "limit": 100,
  "total_pages": 13
}

GET

jobs

expired-jobs

curl -X GET 'https://api.hirebase.org/v2/jobs/expired-jobs?since=2026-01-31&page=1&limit=100' \
  -H 'x-api-key: YOUR_API_KEY'

import requests

url = "https://api.hirebase.org/v2/jobs/expired-jobs"
headers = {
    "x-api-key": "YOUR_API_KEY"
}
params = {
    "since": "2026-01-31",
    "page": 1,
    "limit": 100
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

const url = 'https://api.hirebase.org/v2/jobs/expired-jobs?since=2026-01-31&page=1&limit=100';

const response = await fetch(url, {
  method: 'GET',
  headers: {
    'x-api-key': 'YOUR_API_KEY'
  }
});

const data = await response.json();

{
  "jobs": [
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2c",
      "company_slug": "rentokil-initial-group",
      "job_slug": "service-driver-2353c936",
      "date_expired": "2026-03-01"
    },
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2d",
      "company_slug": "phasor-engineering-inc",
      "job_slug": "commissioning-lead-commissioning-manager-field-based-2cfa04f9",
      "date_expired": "2026-03-01"
    },
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2e",
      "company_slug": "squaredev",
      "job_slug": "fullstack-engineer-88e05e56",
      "date_expired": "2026-03-01"
    },
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2f",
      "company_slug": "zoopla",
      "job_slug": "customer-success-consultant-12-months-ftc-47754cd9",
      "date_expired": "2026-03-01"
    }
  ],
  "total_count": 1247,
  "page": 1,
  "limit": 100,
  "total_pages": 13
}

Overview

The Expired Jobs endpoint allows you to retrieve jobs that have been removed or expired from company career pages after a specified date. This is useful for tracking job lifecycle, maintaining data freshness, and identifying positions that are no longer active.

Authentication

This endpoint requires an API key for all requests, including page 1. See Authentication to get one.

Metering: each request costs 0. Expired data is not billed; only live job data counts against your Jobs API allowance (m_jobs_api_calls).

string

required

Your Hirebase API key

Query Parameters

string

required

Starting date to retrieve expired jobs from. Accepts ISO date format (YYYY-MM-DD) or other standard date strings (e.g., 2026-01-31)

integer

default:"1"

Page number for pagination (min: 1). Response latency grows linearly with page depth — see Pagination for practical limits.

integer

default:"100"

Number of results per page (min: 1, max: 1000)

Response

array

List of expired job objects

Show Job Object

string

Unique job identifier — use it as the job_id in GET /v2/jobs/{job_id} to fetch the full job record

string

Unique identifier for the company

string

Unique identifier for the job posting

string

Date when the job was marked as expired (ISO format: YYYY-MM-DD)

integer

Total number of expired jobs matching the query across all pages

integer

Current page number in the response

integer

Number of results returned per page

integer

Total number of pages available for the query (ceil(total_count / limit))

curl -X GET 'https://api.hirebase.org/v2/jobs/expired-jobs?since=2026-01-31&page=1&limit=100' \
  -H 'x-api-key: YOUR_API_KEY'

import requests

url = "https://api.hirebase.org/v2/jobs/expired-jobs"
headers = {
    "x-api-key": "YOUR_API_KEY"
}
params = {
    "since": "2026-01-31",
    "page": 1,
    "limit": 100
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

const url = 'https://api.hirebase.org/v2/jobs/expired-jobs?since=2026-01-31&page=1&limit=100';

const response = await fetch(url, {
  method: 'GET',
  headers: {
    'x-api-key': 'YOUR_API_KEY'
  }
});

const data = await response.json();

{
  "jobs": [
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2c",
      "company_slug": "rentokil-initial-group",
      "job_slug": "service-driver-2353c936",
      "date_expired": "2026-03-01"
    },
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2d",
      "company_slug": "phasor-engineering-inc",
      "job_slug": "commissioning-lead-commissioning-manager-field-based-2cfa04f9",
      "date_expired": "2026-03-01"
    },
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2e",
      "company_slug": "squaredev",
      "job_slug": "fullstack-engineer-88e05e56",
      "date_expired": "2026-03-01"
    },
    {
      "_id": "665f1c2e9b3d4a5e8f0a1b2f",
      "company_slug": "zoopla",
      "job_slug": "customer-success-consultant-12-months-ftc-47754cd9",
      "date_expired": "2026-03-01"
    }
  ],
  "total_count": 1247,
  "page": 1,
  "limit": 100,
  "total_pages": 13
}

Use Cases

Data Cleanup

Identify and remove stale job postings from your database

Job Lifecycle Tracking

Monitor how long positions remain active

Market Analysis

Analyze hiring velocity by tracking when jobs are filled or closed

Database Synchronization

Keep your local job database in sync with Hirebase

Pagination

Use the page and limit parameters to paginate through large result sets:

# Get first 500 expired jobs
GET /v2/jobs/expired-jobs?since=2026-01-01&page=1&limit=500

# Get next 500 expired jobs  
GET /v2/jobs/expired-jobs?since=2026-01-01&page=2&limit=500

Calculate total pages: use the total_pages field in the response, or ceil(total_count / limit).

Deep pagination limits

Response latency grows linearly with page depth, regardless of the date window. At limit=1000, page 1 responds in a few seconds, page 100 in ~25s, page 300 in ~45s, and pages beyond roughly 400–500 time out. In practice only about the most recent 350,000–450,000 records of any query are reachable, however large its total_count. Because results are sorted by date_expired descending and there is no end-date parameter, a large window cannot be narrowed from the far end — the reachable frontier is always the most recent records.

Recommended usage — incremental sync: poll daily with since=<yesterday>. A one-day window is typically ~150k records (~150 pages at limit=1000), all comfortably reachable. For historical backfill or any pull past the reachable frontier, use Export Expired Jobs — it walks the entire result set server-side with no page-depth limit and is also free.

Very deep page requests can destabilize the endpoint: after requesting extreme offsets, it may return 500 errors on all requests (including page 1) for around a minute before recovering. Back off and retry if you hit this.

Important Notes

The since parameter is required and must be a valid date string

Jobs are considered expired when they are no longer available on the company’s career page
The date_expired field represents when Hirebase detected the job was no longer active (not necessarily when the company removed it)
Results are sorted by date_expired in descending order (most recent first)

Maximum limit per request is 1000 jobs
Performance is bounded by page depth, not date range — see Deep pagination limits. There is no end-date parameter (unsupported query params such as until are silently ignored), so narrowing the window only helps by making since more recent.

Error Responses

Unprocessable Entity

Missing required since query parameter:

{
  "detail": [
    {
      "type": "missing",
      "loc": ["query", "since"],
      "msg": "Field required",
      "input": null
    }
  ]
}

Bad Request

since is present but cannot be parsed as a date (hand-rolled validation after FastAPI accepts the request).

Unauthorized

Invalid or missing API key

{
  "detail": "Invalid API key"
}

Not Found

Invalid endpoint path

{
  "detail": "Not Found"
}

Too Many Requests

Rate limit exceeded

{
  "detail": "Rate limit exceeded. Please try again later."
}

Internal Server Error

Returned for very deep page offsets, and — after such a request — temporarily for all requests to this endpoint (including shallow pages) for around a minute. Back off and retry; the endpoint recovers on its own.

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

Overview

Authentication

Query Parameters

Response

Use Cases

Data Cleanup

Job Lifecycle Tracking

Market Analysis

Database Synchronization

Important Notes

Error Responses

​Overview

​Authentication

​Query Parameters

​Response

​Use Cases

Data Cleanup

Job Lifecycle Tracking

Market Analysis

Database Synchronization

​Pagination

​Deep pagination limits

​Important Notes

​Error Responses

Overview

Authentication

Query Parameters

Response

Use Cases

Pagination

Deep pagination limits

Important Notes

Error Responses