Docs/Reference/Freshness/Get Freshness
GET/v1/freshnessPublic

Get Freshness

How fresh is the data right now.

Returns the observed completion timestamp of the most recent EDINET ingest run, its public status, the lag in minutes since that result became visible, and when the next poll is scheduled. Use this to decide whether to trust a near-realtime answer (low lag) or wait for the next cycle (high lag, retrying / failed status).

Public endpoint: no auth required.

Request headers

Public. No API key required.

Returns · 200

The standard { data, meta } envelope. data contains FreshnessOut.

Envelope

dataFreshnessOut

A single result object.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

FreshnessOut

last_ingest_atstring | null

Observed completion timestamp of the most recent EDINET ingest run (ISO 8601). Falls back to start time for legacy rows.

last_ingest_statusstring | null

Public status of the most recent ingest ('ok', 'delayed', or 'unknown').

filings_todayinteger

Number of filings ingested today.

filings_this_weekinteger

Number of filings ingested this week.

lag_minutesinteger | null

Minutes since the most recent ingest result became visible. Null if no ingest has run.

next_poll_atstring | null

Estimated time of next EDINET poll (ISO 8601).

total_companiesinteger

Total companies in the database.

total_filingsinteger

Total filings in the database.

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.