---
title: "Catalog coverage, bucketed"
method: GET
path: "/v1/coverage"
tags: ["Discovery"]
---

# Catalog coverage, bucketed

`GET /v1/coverage`

## Request

- Base URL: `https://api.stackdata.io`
- URL: `https://api.stackdata.io/v1/coverage`
- Auth: one of:
  - none
  - API key in header `X-API-Key`

Count of datasets grouped along one dimension. Not metered.

## Query parameters

- `by` 'source' | 'kind' | 'publisher_type' | 'licence'

## Response `200`

Buckets with typed counts.

- CoverageResponse
  - `by` string
  - `buckets` object[]
    - `key` string
    - `datasets` TypedCount: A count that states whether it is exact — never a bare integer.
      - `value` integer, required
      - `exact` boolean, required
  - `total` TypedCount: A count that states whether it is exact — never a bare integer.
    - `value` integer, required
    - `exact` boolean, required
  - `meta` Meta: Attached to every JSON response. `harvest` maps each source id to its last successful harvest timestamp.
    - `harvest` object
    - `api_version` string

## Other responses

- `400`: Unknown dimension, or an unknown query parameter.

---

[API](https://skmtc.dev/stackdata/apis/stackdata-api.md) · [All operations](https://skmtc.dev/stackdata/apis/stackdata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stackdata/apis/stackdata-api/revisions/91358ae3f6e8?raw)