API Reference

REST API Reference

32 endpoints for searching, browsing, translating, and exporting classification codes across 1,000+ systems. JSON over HTTP - no SDK required.

Base URL

/api/v1

Auth

Bearer token or wot_ API key

Rate limits

30/min anon, 1,000/min auth

Authentication flow

# 1. Visit /login in a browser, enter your email. You will receive
#    a one-time sign-in link (no password). Click it to sign in.

# 2. From /developers/keys, click "Generate key". Copy the value -
#    we never show it again.

# 3. Use the key in all future requests:
curl /api/v1/search?q=physician \
  -H "Authorization: Bearer wot_abc123..."

Systems & Nodes (6)Search (1)Crosswalks (3)Explore & Compare (7)Countries (2)Classification (3)Authentication (6)Wiki & Content (3)Contact (1)

Systems & Nodes

Browse classification systems and navigate their hierarchies

GET

/api/v1/systems Try it

List all classification systems with metadata and node counts.

Parameter	Location	Type	Description
group_by	query	string	Group results (e.g. "region")
country	query	string	Filter by ISO 3166-1 alpha-2 country code

GET

/api/v1/systems/{id} Try it

Get a system with its root-level nodes.

Parameter	Location	Type	Description
id*	path	string	System ID (e.g. naics_2022, isic_rev4)

GET

/api/v1/systems/{id}/nodes/{code} Try it

Fetch a single classification node by system and code.

Parameter	Location	Type	Description
id*	path	string	System ID
code*	path	string	Node code (e.g. 6211, A01)

GET

/api/v1/systems/{id}/nodes/{code}/children Try it

Get direct children of a node to navigate the hierarchy downward.

Parameter	Location	Type	Description
id*	path	string	System ID
code*	path	string	Parent node code

GET

/api/v1/systems/{id}/nodes/{code}/ancestors Try it

Get the full path from root to this node.

Parameter	Location	Type	Description
id*	path	string	System ID
code*	path	string	Node code

GET

/api/v1/systems/{id}/nodes/{code}/equivalences Try it

Get cross-system equivalence mappings for a node.

Parameter	Location	Type	Description
id*	path	string	System ID
code*	path	string	Node code

Search

Full-text search across 1.2M+ classification nodes

GET

/api/v1/search Try it

Full-text search across all classification systems. Searches titles and codes.

Parameter	Location	Type	Description
q*	query	string	Search query (e.g. "physician", "farming", "6211")
system	query	string	Filter to a specific system ID
limit	query	integer	Max results (1-200)(default: 50)
grouped	query	boolean	Group results by system(default: false)
context	query	boolean	Include ancestors/children for each match(default: false)

Crosswalks

Explore 321K+ equivalence edges connecting classification systems

GET

/api/v1/equivalences/stats Try it

Get counts of equivalence edges per system pair.

Parameter	Location	Type	Description
system_id	query	string	Filter to a specific system

GET

/api/v1/systems/{source}/crosswalk/{target}/graph Try it

Get graph data (nodes + edges) for crosswalk visualization between two systems.

Parameter	Location	Type	Description
source*	path	string	Source system ID
target*	path	string	Target system ID
limit	query	integer	Max edges (1-5000)(default: 500)
section	query	string	Filter to edges within a section code

GET

/api/v1/systems/{source}/crosswalk/{target}/sections Try it

Section-level summary of crosswalk edges. Returns top-level groupings with edge counts for progressive drill-down.

Parameter	Location	Type	Description
source*	path	string	Source system ID
target*	path	string	Target system ID

Explore & Compare

Advanced queries for translation, comparison, and analysis

GET

/api/v1/systems/{id}/nodes/{code}/translations Try it

All cross-system mappings for a code in one call.

Parameter	Location	Type	Description
id*	path	string	System ID
code*	path	string	Node code

GET

/api/v1/systems/{id}/nodes/{code}/siblings Try it

Other nodes at the same hierarchy level under the same parent.

Parameter	Location	Type	Description
id*	path	string	System ID
code*	path	string	Node code

GET

/api/v1/systems/{id}/nodes/{code}/subtree Try it

Aggregate stats for all nodes under a given code: total count, leaf count, max depth.

Parameter	Location	Type	Description
id*	path	string	System ID
code*	path	string	Root node code

GET

/api/v1/compare Try it

Side-by-side top-level sectors for two systems.

Parameter	Location	Type	Description
a*	query	string	First system ID
b*	query	string	Second system ID

GET

/api/v1/diff Try it

Find codes in system A that have no equivalence mapping to system B.

Parameter	Location	Type	Description
a*	query	string	Source system ID
b*	query	string	Target system to check against

GET

/api/v1/nodes/{code} Try it

Find all systems that contain a given code (resolve ambiguous codes).

Parameter	Location	Type	Description
code*	path	string	Code to look up across all systems

GET

/api/v1/systems/stats Try it

Per-system leaf and total node counts for granularity comparison.

Parameter	Location	Type	Description
system_id	query	string	Filter to a specific system

Countries

Taxonomy coverage and profiles for 249 countries

GET

/api/v1/countries/stats Try it

Per-country taxonomy coverage stats for all countries. Used by the world map visualization.

GET

/api/v1/countries/{code} Try it

Taxonomy profile for a country: official systems, regional standards, and sector strengths.

Parameter	Location	Type	Description
code*	path	string	ISO 3166-1 alpha-2 code (e.g. US, DE, IN)

Classification

AI-powered classification of free-text descriptions

POSTPro+

/api/v1/classify

Classify a business, product, occupation, or activity description against taxonomy systems. Returns matching codes with relevance scores.

Parameter	Location	Type	Description
text*	body	string	Free-text description (2-500 chars)
systems	body	string[]	System IDs to search (default: all major systems)
limit	body	integer	Max matches per system(default: 5)

POSTAuth required

/api/v1/systems/{id}/nodes/{code}/generate

Generate AI-suggested sub-classifications for a node (preview only, no DB write).

Parameter	Location	Type	Description
id*	path	string	System ID
code*	path	string	Parent node code
count	body	integer	Number of sub-categories to generate (1-10)(default: 5)

POSTAuth required

/api/v1/systems/{id}/nodes/{code}/generate/accept

Persist user-accepted AI-generated nodes to the database.

Parameter	Location	Type	Description
id*	path	string	System ID
code*	path	string	Parent node code
nodes*	body	GeneratedNode[]	Array of {code, title, description} to accept

Authentication

POST

/api/v1/developers/signup

Send a one-time sign-in link to the given email. The link expires in 15 minutes and is single-use. Backed by the same handler the /login UI calls.

Parameter	Location	Type	Description
email*	body	string	Email address to receive the link

GET

/api/v1/auth/magic-callback

Consume a magic-link token (from the email) and set the dev_session + wot_csrf cookies. Browser flow; the /login page handles this via the /auth/magic page.

Parameter	Location	Type	Description
t*	query	string	One-time magic-link token

POST

/api/v1/auth/logout

Clear the dev_session + wot_csrf cookies on this domain.

POSTAuth required

/api/v1/developers/keys

Create a long-lived API key. Cookie-gated; requires a wot_csrf X-CSRF-Token header.

Parameter	Location	Type	Description
name*	body	string	Human-readable name
scopes	body	string[]	Scope set, e.g. ["wot:read", "wot:list"] or ["wot:"](default: ["wot:"])
expires_in_days	body	integer	Optional expiry in days (1-3650)

GETAuth required

/api/v1/developers/keys

List all API keys for the cookie-authenticated user. No raw key values - prefix only.

DELETEAuth required

/api/v1/developers/keys/{key_id}

Revoke an API key. Cookie-gated; requires the X-CSRF-Token header.

Parameter	Location	Type	Description
key_id*	path	string	API key UUID

Wiki & Content

Curated guide pages and audit reports

GET

/api/v1/wiki Try it

List all wiki guide pages with metadata.

GET

/api/v1/wiki/{slug} Try it

Get a single wiki page by slug.

Parameter	Location	Type	Description
slug*	path	string	Page slug (e.g. getting-started)

GET

/api/v1/audit/provenance Try it

Aggregate audit report: provenance tiers, missing hashes, structural derivation accounting, skeleton systems.

Contact

Enterprise inquiries

POST

/api/v1/contact

Submit an enterprise inquiry or general contact form.

Parameter	Location	Type	Description
name*	body	string	Your name (1-200 chars)
company	body	string	Company name (max 200 chars)
email*	body	string	Email address
message*	body	string	Message (10-2000 chars)

Utility

Bot-facing and LLM-friendly endpoints

GET/robots.txtRobots.txt for search engine crawlers Try it

GET/llms.txtShort summary for LLM crawlers Try it

GET/llms-full.txtComprehensive documentation for LLM ingestion Try it

Need higher limits or custom integrations?

Pro and Enterprise plans include bulk export, classification API, and dedicated support.

View pricing