latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Specialty

Look up a NUCC specialty by taxonomy code

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.

get/specialties/nuccByTaxonomy/{taxonomyCode}

Path parameters

taxonomyCodestring required

NUCC taxonomy code to look up (NUCC Health Care Provider Taxonomy standard, e.g. 207RC0000X). Matching is exact and case-sensitive.

Headers

tenant-idstring required

Response

The first NUCC specialty record matching the given taxonomy code.

idstring

Server-assigned NUCC specialty identifier.

createdAtstring date

Date the record was created.

createdBystring

ID of the user who created the record.

updatedAtstring date

Date the record was last updated.

updatedBystring

ID of the user who last updated the record.