---
title: "List every dataset the API serves"
method: GET
path: "/api/datasets"
tags: ["Datasets"]
---

# List every dataset the API serves

`GET /api/datasets`

## Request

- Base URL: `https://noozra.com`
- URL: `https://noozra.com/api/datasets`
- Auth: none required
- TypeScript: <https://skmtc.dev/noozra/apis/noozra-news-api/docs/api/datasets/get.ts> (a function with typed inputs; its response is checked against the schema)

Every dataset (news, communities, posts, jobs, federal contract opportunities and awards, building permits and new businesses) with its endpoints, filters, sorts, paging and docs, when it was last current (`as_of`) and whether a source of it is behind (`status`). Open to every caller, with or without a key, and not counted against any limit.

## Response `200`

OK

- DatasetsResponse
  - `auth` string, required
  - `base_url` string, uri, required
  - `common_fields` object, required
  - `common_fields_apply_to` string[]
  - `datasets` Dataset[], required
    - `as_of` string, date-time, nullable: When the dataset was last known current.
    - `coverage` string[], nullable: The city slugs a city dataset covers; null for the others.
    - `date_field` string, required
    - `date_meaning` string
    - `docs` string, uri, required
    - `endpoint` string, required: The list endpoint, a path on base_url.
    - `filters` string[], required
    - `item_endpoint` string, nullable
    - `items_key` string, required: The key of the array in a list answer.
    - `name` string, required
    - `other_endpoints` string[]
    - `paging` string, required
    - `sorts` string[], required: The default first; pass another as sort=.
    - `status` 'ok' | 'delayed' | 'unknown', required
    - `tag` string, required
    - `title` string, required
  - `openapi` string, uri, required
  - `statuses` object

## Other responses

- `429`: Too many requests (honor the Retry-After header)

## Changes

- **2026-10-29** `e0c2d7df6d6f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/noozra/apis/noozra-news-api/changes/api/datasets/get.md)

---

[API](https://skmtc.dev/noozra/apis/noozra-news-api.md) - [All operations](https://skmtc.dev/noozra/apis/noozra-news-api/llms.txt) - [OpenAPI document](https://skmtc.dev/noozra/apis/noozra-news-api/revisions/9067da767e84?raw)