---
title: "Look up a NUCC specialty by taxonomy code"
method: GET
path: "/specialties/nuccByTaxonomy/{taxonomyCode}"
tags: ["Specialty"]
---

# Look up a NUCC specialty by taxonomy code

`GET /specialties/nuccByTaxonomy/{taxonomyCode}`

Returns the first NUCC specialty record whose taxonomy code matches the supplied value, scoped to the calling tenant.

**When to use:** Use this endpoint to resolve a known NUCC taxonomy code (from the NUCC Health Care Provider Taxonomy standard, e.g. `207RC0000X`) to the tenant's internal NUCC specialty record. To retrieve a specialty by its internal ID use `GET /specialties/{id}`.

**Preconditions:** Requires the `READ_SPECIALTY` permission. The `tenant-id` header must be supplied. `taxonomyCode` is matched by exact, case-sensitive string equality against the stored value; no fixed length or character-set format is enforced by the API.

**Result:** Returns the first matching NUCC specialty record. If multiple records share the same taxonomy code, only the first of up to 10 matches is returned; the selection order is not guaranteed. Read-only — no side effects.

## Path parameters

- `taxonomyCode` string, required

## Headers

- `tenant-id` string, required

## Response `200`

The first NUCC specialty record matching the given taxonomy code.

- object
  - `id` string — Server-assigned NUCC specialty identifier.
  - `createdAt` string, date — Date the record was created.
  - `createdBy` string — ID of the user who created the record.
  - `updatedAt` string, date — Date the record was last updated.
  - `updatedBy` string — ID of the user who last updated the record.
  - `data` NuccSpecialtySchema — Represents the NUCC specialty information options for a healthcare provider.
    - `classification` string, required — The classification of the NUCC specialty
    - `specialization` string, nullable — The specific specialization within the NUCC classification
    - `category` 'Individual' | 'Non-Individual', required — Allowed categories for NUCC Specialty
    - `displayName` string, required — The human-readable name of the NUCC specialty
    - `specialtyNuccTaxonomyCode` string, required — The NUCC taxonomy code associated with the specialty

## Other responses

- `401` — Unauthorized - Authentication required
- `403` — Forbidden - User does not have required permissions
- `404` — No NUCC specialty exists with the given taxonomy code for this tenant.
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)