---
title: "How recently the ledger was verified, and how much of it is inferred."
method: GET
path: "/v1/meta/freshness"
tags: ["meta"]
---

# How recently the ledger was verified, and how much of it is inferred.

`GET /v1/meta/freshness`

## Request

- Base URL: `https://api.jobopportunitiesapi.org`
- URL: `https://api.jobopportunitiesapi.org/v1/meta/freshness`
- Auth: HTTP bearer

The claim the subscription is sold on, made checkable. Every live
listing is re-confirmed at its source on a rolling cycle; this reports
the coverage, plus per-field provenance totals so a buyer can size the
honest subset before they pay for it.

## Response `200`

Freshness and coverage report.

- object
  - `data` object
    - `closures` object
      - `last_24h` integer
      - `last_7d` integer
    - `field_coverage` object
      - `description` integer
      - `employment_type` integer
      - `remote_inferred` integer
      - `remote_inferred_pct` number
      - `remote_published` integer
      - `remote_published_pct` number
      - `salary_published` integer
    - `generated_at` string
    - `live_listings` integer
    - `verification` object
      - `newest_verification` string
      - `oldest_verification` string
      - `reverified_last_24h` integer
      - `reverified_last_24h_pct` number
      - `reverified_last_48h` integer
      - `reverified_last_48h_pct` number
      - `reverified_last_7d` integer
      - `reverified_last_hour` integer

## Other responses

- `401`: Missing, unknown, revoked or expired key. All four are reported identically.
- `429`: Over your plan's per-minute or per-day limit. `Retry-After` says how long (seconds to the next minute boundary, or to UTC midnight on a daily breach). The body says exactly when the limit resets (`resets_at`, `resets_at_text`) and, when a higher plan exists, links a same-key upgrade (`upgrade_url`).

---

[API](https://skmtc.dev/jobopportunitiesapi/apis/job-opportunities-api.md) · [All operations](https://skmtc.dev/jobopportunitiesapi/apis/job-opportunities-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jobopportunitiesapi/apis/job-opportunities-api/revisions/b5ef9709a0c9?raw)