> ## Documentation Index > Fetch the complete documentation index at: https://docs.hebbianrobotics.com/llms.txt > Use this file to discover all available pages before exploring further. # Get dataset environments, objects, actions > Returns published terms, their tiers and categories, and diversity metrics. Use `section` to request one vocabulary section. ## OpenAPI ````yaml https://api.hebbianrobotics.com/public-openapi.json get /api/v1beta/quality/vocabulary openapi: 3.1.0 info: description: >- Use content diversity, frame-quality, and hand-activity metrics to evaluate robot and egocentric video datasets. Start with `GET /api/v1beta/access`, then list available datasets with `GET /api/v1beta/quality/datasets`. license: identifier: Apache-2.0 name: Apache-2.0 title: Robotics Data Quality API version: v1beta servers: - description: Production API url: https://api.hebbianrobotics.com security: - {} - bearer_token: [] tags: - description: >- Content diversity, frame-quality, and hand-activity metrics for robotics video data. name: quality - description: Scope and capabilities granted by a bearer token. name: access paths: /api/v1beta/quality/vocabulary: get: tags: - quality summary: Get dataset environments, objects, actions description: >- Returns published terms, their tiers and categories, and diversity metrics. Use `section` to request one vocabulary section. operationId: getQualityVocabulary parameters: - description: Dataset ID from `GET /api/v1beta/quality/datasets`. in: query name: dataset required: true schema: type: string - description: |- Opaque `vocabulary` token from an earlier response. Omit to use the latest vocabulary. in: query name: vocabulary required: false schema: type: string - description: Return only `environments`, `objects`, or `actions`. in: query name: section required: false schema: $ref: '#/components/schemas/QualityVocabularySectionQuery' responses: '200': content: application/json: schema: $ref: '#/components/schemas/QualityVocabularyResponse' description: Published vocabulary by section headers: x-request-id: description: >- Request correlation identifier supplied by the caller or generated by the API schema: type: string '400': content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' description: The dataset ID or section is invalid headers: x-request-id: description: >- Request correlation identifier supplied by the caller or generated by the API schema: type: string '401': content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' description: A valid bearer token is required headers: WWW-Authenticate: description: Bearer authentication challenge schema: type: string x-request-id: description: >- Request correlation identifier supplied by the caller or generated by the API schema: type: string '403': content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' description: The bearer token cannot read quality measurements headers: x-request-id: description: >- Request correlation identifier supplied by the caller or generated by the API schema: type: string '404': content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' description: The dataset, vocabulary, or a source measurement is unavailable headers: x-request-id: description: >- Request correlation identifier supplied by the caller or generated by the API schema: type: string '409': content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' description: >- The requested vocabulary is stale; omit the vocabulary token and retry headers: x-request-id: description: >- Request correlation identifier supplied by the caller or generated by the API schema: type: string '500': content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' description: The server could not read vocabulary measurements headers: x-request-id: description: >- Request correlation identifier supplied by the caller or generated by the API schema: type: string '503': content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' description: The server is temporarily unavailable or overloaded headers: Retry-After: description: Seconds to wait before retrying an overloaded request schema: type: string x-request-id: description: >- Request correlation identifier supplied by the caller or generated by the API schema: type: string '504': content: application/json: schema: $ref: '#/components/schemas/ApiErrorBody' description: The request exceeded the server processing deadline headers: x-request-id: description: >- Request correlation identifier supplied by the caller or generated by the API schema: type: string security: - bearer_token: [] components: schemas: QualityVocabularySectionQuery: enum: - environments - objects - actions type: string QualityVocabularyResponse: description: Published dataset vocabulary and measurement completeness. properties: coverage_share: description: |- Measurement completeness in `[0, 1]`. `null` when a reliable denominator is unavailable. format: double maximum: 1 minimum: 0 type: - number - 'null' dataset: description: Dataset ID used in the request. type: string sections: items: $ref: '#/components/schemas/QualityVocabularySectionDto' type: array vocabulary: description: >- Opaque vocabulary token. Matching tokens identify results from the same vocabulary measurement. type: string required: - dataset - vocabulary - coverage_share - sections type: object ApiErrorBody: description: Error payload returned for handled API failures. properties: code: description: Machine-readable error code, e.g. `dataset_not_found`. type: string message: description: Human-readable message. type: string required: - code - message type: object QualityVocabularySectionDto: description: Vocabulary measurements for environments, objects, or actions. properties: distinct_kinds: description: Broader categories represented by the published terms. minimum: 0 type: integer distinct_terms: description: Published terms with an assigned tier. minimum: 0 type: integer effective_distinct_terms: description: >- Term count adjusted for repetition. Higher values indicate more terms are represented consistently. format: double minimum: 0 type: number section: description: '`environments`, `objects` or `actions`.' type: string size_adjusted_distinct_terms: description: >- Term breadth adjusted to support comparisons across differently sized datasets. `null` when the measurement cannot support the adjustment. format: double minimum: 0 type: - number - 'null' terms: description: Every published term, most frequent first. items: $ref: '#/components/schemas/QualityTermDto' type: array tiers: description: All available tiers, including tiers with no matching terms. items: $ref: '#/components/schemas/QualityVocabularyTierDto' type: array untiered_terms: description: Published terms without an assigned tier. items: type: string type: array required: - section - distinct_terms - effective_distinct_terms - size_adjusted_distinct_terms - distinct_kinds - tiers - untiered_terms - terms type: object QualityTermDto: description: One published vocabulary term. properties: kind: description: Broader category. `null` when the term is its own category. type: - string - 'null' spellings: description: Observed wordings normalized into this term. items: type: string type: array term: description: Normalized term published by the API. type: string tier: description: Assigned tier. `null` when the term has no tier. type: - string - 'null' required: - term - tier - kind - spellings type: object QualityVocabularyTierDto: description: Summary of one vocabulary tier. properties: distinct_terms: description: Number of published terms in this tier. minimum: 0 type: integer example_terms: description: Frequent terms in this tier. items: type: string type: array label: description: Display name. type: string representation_share: description: >- This tier's relative representation in assessed footage, in `[0, 1]`. format: double maximum: 1 minimum: 0 type: number tier: description: Stable tier or environment-category name. type: string required: - tier - label - distinct_terms - representation_share - example_terms type: object securitySchemes: bearer_token: description: Bearer access token issued through OAuth 2.0 client credentials. scheme: bearer type: http ````