List specialties configured for the tenant
GET/tenant-specialties
Returns the specialties that have been configured for the tenant identified by the tenant-id header.
What it does: Fetches a page of tenant specialty records — each record links a global specialty definition to this tenant and may carry tenant-specific metadata.
When to use: Use this endpoint to display or enumerate specialties active for a tenant. To narrow results to a specific classification taxonomy, use GET /tenant-specialties/by-classification instead.
How to call it: Supply the required tenant-id header. The name query parameter is accepted but is not currently forwarded to the data layer — it has no effect on the returned results (tracked as a known limitation, not fixed by this documentation change). Pagination is not exposed: every call returns a fixed first page of up to 10 records regardless of how many tenant specialties exist for the tenant.
What you get back: A JSON object containing a data array of tenant specialty objects and a totalCount integer reflecting the full count before pagination. Requires the READ_TENANT_SPECIALTY permission.
Request
Responses
- 200
- 400
- 401
- 403
- 500
The (fixed first page of the) tenant's specialties, plus the total count before pagination.
Missing or invalid tenant-id header.
Unauthorized - the request is missing a valid JWT.
Forbidden - the caller lacks the READ_TENANT_SPECIALTY permission for this tenant.
Internal Server Error - an unexpected error occurred while retrieving the list.