latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Specialty

List medical specialties for a tenant

Returns a page of medical specialty records (platform-defined specialties, not NUCC taxonomy entries) scoped to the calling tenant.

When to use: Use this endpoint to populate specialty pickers or to browse available specialties. For a single specialty by ID use GET /specialties/{id}; for NUCC taxonomy lookups use GET /specialties/nuccByTaxonomy/{taxonomyCode}.

Preconditions: Requires the READ_SPECIALTY permission. The tenant-id header must be supplied on every request.

Results: Returns an object with a totalCount field and a data array of specialty objects. This endpoint currently returns a fixed first page of up to 10 records; offset/limit query parameters are not exposed. The name parameter is accepted but is not currently applied by the service — supplying a value has no effect on the results returned.

get/specialties

Query parameters

namestring

Specialty name to filter by. Currently accepted but not applied by the service — has no effect on the returned results.

Headers

tenant-idstring required

Response

A page of up to 10 specialty records for the tenant, with the total matching count.

totalCountinteger