563848e0ecc0
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.
Query parameters
Specialty name to filter by. Currently accepted but not applied by the service — has no effect on the returned results.
Headers
Response
A page of up to 10 specialty records for the tenant, with the total matching count.