---
title: "Coverage, source commit and synchronization status."
method: GET
path: "/api/legislation"
---

# Coverage, source commit and synchronization status.

`GET /api/legislation`

## Request

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

Returns: {ok,total,official_total,official_checked_at,official_error,source_commit,checked_at,changed_at,error,scope,source_url,seed_url,currency_verified:false,facets:{types,years,authorities:[{value,total}]},search,okf_url}. Dates are UTC. Facets describe the complete collection. official_total counts documents collected directly from Congress. The initial snapshot remains available during the bounded refresh. ok=false reports stale or failed synchronization.

## Response `200`

{ok,total,official_total,official_checked_at,official_error,source_commit,checked_at,changed_at,error,scope,source_url,seed_url,currency_verified:false,facets:{types,years,authorities:[{value,total}]},search,okf_url}. Dates are UTC. Facets describe the complete collection. official_total counts documents collected directly from Congress. The initial snapshot remains available during the bounded refresh. ok=false reports stale or failed synchronization.

## Other responses

- `400`: Invalid query or part.
- `404`: Document or part not found.
- `429`: Reader busy. Retry after the stated delay.
- `503`: The corpus is unavailable. Do not treat this as no results.

---

[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)