---
title: "The AIO Framework V/E/S vocabulary, machine-readable"
method: GET
path: "/api/framework/vocabulary"
tags: ["framework"]
---

# The AIO Framework V/E/S vocabulary, machine-readable

`GET /api/framework/vocabulary`

## Request

- Base URL: `https://aioq.org`
- URL: `https://aioq.org/api/framework/vocabulary`
- Auth: none declared

Returns the 39 codes of the AIO 00011 common vocabulary (19 values, 10 evidence types, 10 source classes), the context axes of an AIO 20002 record, the record grammar, and a JSON-Schema description of one record line. This is the canonical machine-readable form of the standard.

## Query parameters

- `layer` 'V' | 'E' | 'S' | 'L4' | 'L3' | 'L2'
- `format` 'schema'

## Response `200`

The vocabulary document, one layer, or the record JSON Schema.

- object
  - `standard` string
  - `specVersion` string
  - `codeCount` integer
  - `license` string
  - `layers` object[]
    - `axis` 'V' | 'E' | 'S', required
    - `benchmarkLayer` 'L4' | 'L3' | 'L2', required
    - `name` object: Localized text. `en` is always present.
      - `en` string, required
      - `ko` string
    - `theoreticalBasis` string
    - `ordering` 'incommensurable' | 'rigor-ordered' | 'authority-ordered'
    - `codeCount` integer
    - `codes` object[], required
      - `code` string, required: Three-letter code used verbatim in an AIO 20002 record.
      - `name` object, required: Localized text. `en` is always present.
        - `en` string, required
        - `ko` string
      - `definition` object, required: Localized text. `en` is always present.
        - `en` string, required
        - `ko` string
      - `behavior` object: Localized text. `en` is always present.
        - `en` string, required
        - `ko` string
  - `context` object
  - `logLine` object
    - `format` string
    - `grammar` string
    - `pattern` string: Regular expression matching a complete record line.
    - `examples` object[]
    - `jsonSchema` object: JSON Schema 2020-12 description of one record.

## Other responses

- `400`: Unknown layer.

---

[API](https://skmtc.dev/aioq/apis/aio-public-api.md) · [All operations](https://skmtc.dev/aioq/apis/aio-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aioq/apis/aio-public-api/revisions/377b76120162?raw)