---
title: "Valid category and topic filter values"
method: GET
path: "/v1/vocabulary"
tags: ["Meetings"]
---

# Valid category and topic filter values

`GET /v1/vocabulary`

## Request

- Base URL: `https://api.openpublica.com`
- URL: `https://api.openpublica.com/v1/vocabulary`
- Auth: none declared

Read this before filtering — `category_tag`s are opaque UUIDs you cannot guess.

## Query parameters

- `government_id` string
- `government_ids` string
- `start_date` string, date
- `end_date` string, date
- `limit` integer

## Response `200`

Categories and topics with counts

- object
  - `data` Vocabulary, required
    - `categories` object[]
      - `name` string
      - `category_tag` string
      - `count` integer
    - `topics` object[]
      - `topic` string
      - `count` integer
  - `meta` object, required
    - `default_window_days` integer

## Other responses

- `400`: Malformed or invalid parameters.
- `429`: Per-IP rate limit exceeded.
- `500`: Internal server error.

---

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