---
title: "Size of the index by provenance, and when it last changed."
method: GET
path: "/api/okf/stats"
---

# Size of the index by provenance, and when it last changed.

`GET /api/okf/stats`

## Request

- Base URL: `https://okfindex.com`
- URL: `https://okfindex.com/api/okf/stats`
- Auth: none declared

Returns: { total, by_origin, by_version[{v,n}], by_type[{v,n}], by_concepts[{v,n}], by_license[{v,n}], by_language[{v,n}], last_update }

## Response `200`

{ total, by_origin, by_version[{v,n}], by_type[{v,n}], by_concepts[{v,n}], by_license[{v,n}], by_language[{v,n}], last_update }

- IndexStats: Size of the index by provenance, the facets a search can filter by, and when it last changed.
  - `total` integer, required: Live bundles in the index.
  - `by_origin` object, required: `{github, domain}`: live bundles found by the sweep and submitted by domains.
  - `by_version` Faceta[], required: Live bundles per declared `okf_version`, most common first (up to 12).
    - `v` string, required: The stored facet value or the concept-count band.
    - `n` integer, required: Live bundles with that value.
  - `by_type` Faceta[], required: Declared root types, up to 12; roots need not declare a type.
    - `v` string, required: The stored facet value or the concept-count band.
    - `n` integer, required: Live bundles with that value.
  - `by_concepts` Faceta[], required: Root entry counts in bands 0, 1-5, 6-20, 21-100, 101+.
    - `v` string, required: The stored facet value or the concept-count band.
    - `n` integer, required: Live bundles with that value.
  - `by_license` Faceta[], required: Repository licenses, up to 12; absent license is unknown.
    - `v` string, required: The stored facet value or the concept-count band.
    - `n` integer, required: Live bundles with that value.
  - `by_language` Faceta[], required: Live bundles per repository language, most common first (up to 12); domain bundles have none.
    - `v` string, required: The stored facet value or the concept-count band.
    - `n` integer, required: Live bundles with that value.
  - `last_update` string, nullable, required: Newest `updated_at` among live bundles, `YYYY-MM-DD HH:MM:SS` UTC.

---

[API](https://skmtc.dev/okfindex/apis/okf-index.md) · [All operations](https://skmtc.dev/okfindex/apis/okf-index/llms.txt) · [OpenAPI document](https://skmtc.dev/okfindex/apis/okf-index/revisions/4b13ca3c739f?raw)