---
title: "Read the public bar vocabulary and ready-made details"
method: GET
path: "/v1/vocabulary"
---

# Read the public bar vocabulary and ready-made details

`GET /v1/vocabulary`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/vocabulary`
- Auth: none required

## Headers

- `If-None-Match` string

## Response `200`

Vocabulary for all result kinds

- object
  - `data` VocabularyData, required
    - `default_count` 25
    - `kinds` VocabularyKind[], required
      - `kind` 'local_business' | 'creator' | 'organization' | 'storefront_product' | 'app_listing' | 'job_posting' | 'scholarly_work' | 'tender' | 'grant' | 'software_repository' | 'software_package' | 'dataset' | 'clinical_trial' | 'regulatory_document' | 'vulnerability' | 'book' | 'podcast' | 'web_page' | 'knowledge_entity' | 'person', required
      - `name` string, required
      - `plural` string, required
      - `types` string[], required
      - `details` VocabularyDetail[], required
        - `field_id` string, required
        - `label` string, required
        - `instant` boolean, required
      - `examples` string[], required
      - `suggested` boolean, required

## Other responses

- `304`: Vocabulary unchanged; empty body
- `default`: Error envelope

---

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