Skip to main content
GET
/
v3
/
framework
Get the v3 framework taxonomy
curl --request GET \
  --url https://api.webacy.com/v3/framework
{
  "schema_version": "3.0",
  "framework_version": "v1",
  "supported_versions": [
    "v1"
  ],
  "supported_grading_schemes": [
    "v1",
    "v2"
  ],
  "categories": [
    {
      "key": "smart_contract",
      "name": "Smart contract",
      "description": "Code quality, verification, audits, upgradeability, and proxy structure of the contracts that custody user funds.",
      "criteria": [
        {
          "key": "contract_verified",
          "name": "Contract verified on explorer",
          "live": true
        },
        {
          "key": "formal_verification",
          "name": "Formal verification",
          "live": false
        }
      ]
    }
  ]
}
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 (/api/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