---
title: "The classification tree + corpus health (OPEN — no key, not metered)"
method: GET
path: "/us-law/taxonomy"
---

# The classification tree + corpus health (OPEN — no key, not metered)

`GET /us-law/taxonomy`

## Request

- Base URL: `https://ai-law-tracker.com/api/v1`
- URL: `https://ai-law-tracker.com/api/v1/us-law/taxonomy`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer

The 33 branches and 227 subcategories the corpus is classified into, with descriptions, so a consumer can build ?branch= / ?domain= filters without guessing. Deliberately OPEN to everyone and NOT metered: it DESCRIBES the corpus, it is not the corpus, and a classification a customer cannot inspect is a black box.

Also returns `meta.health` — `records_total`, `records_placeholder` (records still in the `other_unclassified` bucket) and `avg_domains_per_record`. That placeholder count is published rather than hidden: it is the honest measure of how far the classification actually reaches, and it is the number every public coverage claim on the site is checked against.

## Response `200`

Branches, subcategories and corpus health.

- object
  - `api_version` string
  - `data` object
    - `branches` object[]
  - `meta` object
    - `branches` integer
    - `subcategories` integer
    - `health` object

---

[API](https://skmtc.dev/ai-law-tracker/apis/ai-law-tracker-public-laws-api.md) · [All operations](https://skmtc.dev/ai-law-tracker/apis/ai-law-tracker-public-laws-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ai-law-tracker/apis/ai-law-tracker-public-laws-api/revisions/25403268a853?raw)