{"uid":"cap_lcuM7rNiRH7ckjvwNYj3r","slug":"nucc-taxonomy-code-decoder-7ef3a689","name":"NUCC Taxonomy Code Decoder","description":"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.","url":"https://2s.io/api/medical/taxonomy-specialty","method":"GET","headers":{},"bodySchema":{"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."}}}}}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.009","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"0.9000","medianCents":"0.9000","p90Cents":"0.9000","minCents":"0.9000","maxCents":"0.9000","p95Cents":"0.9000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.009/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nKjjdJDN1u3FxGJ_UD1Ik","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.009","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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).","exampleAgentPrompt":"What specialty does the NUCC taxonomy code 207L00000X represent? Give me the full grouping, classification, and display name.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:18:39.477Z","isFirstParty":false}