# NUCC Taxonomy Code Decoder

> NUCC Taxonomy Code Decoder is a paid API for AI agents from 2s.io, paid per call via x402, $0.009/call, status unknown (last checked 2026-09-14).

Resolves a NUCC Health Care Provider Taxonomy code into its human-readable specialty grouping, classification, specialization, display name, and provider section (Individual vs Non-Individual).

## Facts

- Endpoint: GET https://2s.io/api/medical/taxonomy-specialty
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nucc-taxonomy-code-decoder-7ef3a689
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lcuM7rNiRH7ckjvwNYj3r

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nucc-taxonomy-code-decoder-7ef3a689
```

Example prompt: What specialty does the NUCC taxonomy code 207L00000X represent? Give me the full grouping, classification, and display name.

## When to prefer this

Use this endpoint when you have a raw NUCC taxonomy code (e.g. from an NPI lookup, NPPES record, or insurance claim) and need to display or process its human-readable specialty. Ideal for claims processing, provider credentialing, provider directory enrichment, and any pipeline that ingests raw NPI data. Prefer this over building your own NUCC code table — the dataset is version-pinned and maintained.

## Known failure modes

- Invalid or unrecognized taxonomy code returns an error or empty result
- Missing required 'code' query parameter returns a 400 bad request
- Malformed code (wrong length or characters) may return no match
- Network or service unavailability returns 5xx error
- Payment failure via x402 protocol prevents access

## How this service works

Resolve a NUCC Health Care Provider Taxonomy code -- the specialty code returned by medical.npi and printed on every NPPES record -- into its human specialty: grouping (top level, e.g. "Allopathic & Osteopathic Physicians"), classification (e.g. "Anesthesiology"), specialization, the official display name, and the section (Individual vs Non-Individual). The decode step every claims, credentialing, and provider-directory agent needs to turn an opaque 10-char taxonomy code into a readable specialty. Data: NUCC code set (public domain), bundled and version-pinned. Note: the CMS Medicare 2-char physician-specialty crosswalk is published only as a PDF, so medicareSpecialty is returned null (DEFERRED) rather than guessed.

## Output

Returns the NUCC taxonomy code's human-readable grouping (e.g. 'Allopathic & Osteopathic Physicians'), classification (e.g. 'Anesthesiology'), specialization, official display name, and section (Individual vs Non-Individual). The medicareSpecialty crosswalk field is returned as null since CMS only publishes that mapping as a PDF.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "code"
     ],
     "properties": {
      "code": {
       "type": "string",
       "description": "NUCC taxonomy code, e.g. 207L00000X."
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "properties": {
   "ok": {
    "type": "boolean"
   },
   "items": {
    "type": "array",
    "items": {
     "type": "object",
     "properties": {
      "code": {
       "type": "string"
      },
      "section": {
       "type": "string"
      },
      "grouping": {
       "type": "string"
      },
      "displayName": {
       "type": "string"
      },
      "classification": {
       "type": "string"
      },
      "specialization": {},
      "medicareSpecialty": {}
     }
    }
   },
   "total": {
    "type": "integer"
   },
   "source": {
    "type": "object",
    "properties": {
     "url": {
      "type": "string"
     },
     "license": {
      "type": "string"
     },
     "provider": {
      "type": "string"
     }
    }
   }
  }
 },
 "example": {
  "ok": true,
  "items": [
   {
    "code": "207L00000X",
    "section": "Individual",
    "grouping": "Allopathic & Osteopathic Physicians",
    "displayName": "Anesthesiology Physician",
    "classification": "Anesthesiology",
    "specialization": null,
    "medicareSpecialty": null
   }
  ],
  "total": 1,
  "source": {
   "url": "https://www.nucc.org/",
   "license": "Public domain (NUCC).",
   "provider": "NUCC Health Care Provider Taxonomy code set"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nucc-taxonomy-code-decoder-7ef3a689/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)