563848e0ecc0
List tenant specialties matching a classification and category
Returns tenant specialties for the current tenant that belong to a given classification source and category within that source.
What it does: Filters the tenant's specialty list by a classification taxonomy. For example, a classification source of nucc combined with a category of Individual returns only specialties belonging to that NUCC grouping. Both parameters are required, free-text strings — they are not validated against an enum or fixed value set, either in this service or the data layer.
Aggregating across sources: Pass classificationSource=ALL to return specialties matching the given category across every classification source configured for the tenant. Results are not deduplicated: the same specialty can legitimately belong to more than one classification source, and each occurrence is returned. ALL is handled by the underlying data layer, not validated or special-cased here — any other free-text value is still passed through unchanged, as before.
Sort order: Results are always returned sorted by specialty display name, ascending (case-sensitive, data-layer-enforced). This ordering applies to every classificationSource value, including ALL, and cannot be overridden by the caller — there is no sort query parameter.
When to use: Use this endpoint when you need specialties scoped to a specific taxonomy rather than the full tenant specialty list. Use GET /tenant-specialties when you need all specialties regardless of classification.
How to call it: Supply the required tenant-id header plus both classificationSource and category query parameters. Omitting either returns 400. Requires the READ_TENANT_SPECIALTY permission.
What you get back: A list of matching tenant specialty objects, sorted by display name ascending (see above), each including its classificationSource, specialtyCategory, and taxonomyCode. Results are served from a cache with a 5-minute TTL that is not invalidated on writes — a specialty created, updated, or deleted (including changes that affect ALL's aggregated set) may take up to 5 minutes to be reflected here.
Query parameters
Category to filter by within the classification source (e.g. "Individual"). Free text — not restricted to a fixed set of values.
Classification source to filter by (e.g. "nucc"), or the special value "ALL" to aggregate specialties across every classification source for the tenant (not deduplicated — the same specialty may appear once per source it belongs to). Otherwise free text — not restricted to a fixed set of values.
Headers
Tenant identifier that scopes the query.
Response
The tenant specialties matching the given classification source (or, for classificationSource=ALL, the union across all sources, not deduplicated) and category, sorted by display name ascending. May reflect data up to 5 minutes stale (see caching note above).