---
title: "Get Freshness"
method: GET
path: "/v1/freshness"
tags: ["freshness"]
---

# Get Freshness

`GET /v1/freshness`

Return data freshness metrics. Public endpoint, no auth required.

## Response `200`

Successful Response

- SingleResponseFreshnessOut
  - `data` FreshnessOut, required
    - `last_ingest_at` string, nullable — Timestamp of the last successful EDINET ingest (ISO 8601).
    - `last_ingest_status` string, nullable — Status of the last ingest ('ok' or 'error').
    - `filings_today` integer, required — Number of filings ingested today.
    - `filings_this_week` integer, required — Number of filings ingested this week.
    - `lag_minutes` integer, nullable — Minutes since last successful ingest. Null if no ingest has run.
    - `next_poll_at` string, nullable — Estimated time of next EDINET poll (ISO 8601).
    - `total_companies` integer, required — Total companies in the database.
    - `total_filings` integer, required — Total filings in the database.
  - `meta` Meta, required
    - `total` integer, nullable — Total number of matching records (list endpoints only).
    - `limit` integer, nullable — Maximum records returned per page.
    - `offset` integer, nullable — Number of records skipped (offset-based pagination).
    - `next_cursor` string, nullable — Opaque cursor for the next page (keyset pagination). Null on the last page.
    - `request_id` string, required — Unique request identifier for tracing and support (e.g. 'req_abc123').

---

[API](https://skmtc.net/axioradev/apis/axiora-api.md) · [All operations](https://skmtc.net/axioradev/apis/axiora-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axioradev/axiora-api/revisions/b8bf48556541/schema)