Specialties

Per-county aggregate (state-level density proxy)

NPPES does not publish a county-level field of practice in its public API. Responses surface the parent state's density figure with the county context preserved in meta.geo_scope_note. Mirrors the §191 Access Gap Lookup Tool's honesty disclosure.

Optional subspecialty filter (§193). Same semantics as /specialties/{code}/by-state — the recomputed slice is intersected with the requested state, and the resulting state-level row is returned in data.state_level_supply.

get/api/v1/specialties/{code}/by-county

Request

  • Base URL: https://fonteum.com
  • URL: https://fonteum.com/api/v1/specialties/{code}/by-county
  • Auth: HTTP bearer

Path parameters

codestring required

Query parameters

statestring required
Example:CA
county_fipsstring required
Example:06037
subspecialtystring
Example:207NS0135X

NUCC taxonomy code to filter on. See /specialties/{code}/by-state description for the per-primary registry.

max_stalenessstring
Example:48h

Caller stored-snapshot age bar (moat-defense #125). A positive duration — 48h, 7d, 90m, or a bare number of hours. The maximum age any consulted stored source snapshot may have for this request; it is not an upstream-release freshness guarantee. Response carries meta.freshness_policy; absence of the parameter leaves default behaviour unchanged.

max_staleness_mode'flag' | 'reject'

What to do when a source is behind the max_staleness bar: flag (default) returns 200 with a stale flag; reject returns 409. on_stale=reject|409 is accepted as an alias.

Response

County-context state-level aggregate.

dataobject

Example response

{
  "meta": {
    "request_id": "req_abc123def456",
    "freshness": [
      {
        "source_id": "oig-leie"
      }
    ],
    "freshness_policy": {
      "max_staleness": "48h",
      "max_staleness_hours": 48
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.