Skip to main content
GET
Get the v3 framework taxonomy
This endpoint returns the canonical V3 risk framework — the seven categories and their criteria, with each criterion’s live/planned status.
Understanding the version numbers. Three independent version axes show up on the V3 surface — they are not the same number:
  • API version v3 — the URL path (/v3/...) and the response schema_version (3.0).
  • framework_version — which criteria taxonomy was used. v1 today (the only supported value).
  • grading_scheme — which letter-grade band table is applied. v2 is the default (the standard 11-band scale); v1 is frozen and deprecated.
So the V3 API uses framework_version=v1 and grading_scheme=v2 by default. The v1 you may see on framework_version is not an older API — it’s just the current taxonomy version.

Query Parameters

framework_version
enum<string>
default:v1

Framework version to pin (default v1).

Available options:
v1

Response

Framework taxonomy.

v3 framework taxonomy (RFC-019). The canonical machine-readable category/criteria catalog; Mintlify renders the methodology page from this.

schema_version
string
required
Example:

"3.0"

framework_version
string
required
Example:

"v1"

supported_versions
string[]
required
supported_grading_schemes
string[]
required
categories
object[]
required