Get local authority metrics

Requested fee and occupancy values for an ONS district, county or unitary authority code. Districts resolve to their social-care parent authority. No radius or projection year is accepted.

GET /v1/local-authority-metrics

Get local authority metrics

cURL

curl --request GET \
  --url https://api.catchment.app/v1/local-authority-metrics \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "request_id": "2709fafa-f73b-40f6-a26e-69c1398e0b46",
  "local_authority": {
    "requested_area": {
      "code": "E07000110",
      "name": "Maidstone",
      "kind": "lad"
    },
    "authority": {
      "code": "E10000016",
      "name": "Kent",
      "kind": "ctyua"
    },
    "values": {
      "la_avg_fee_residential_week": 1063,
      "la_avg_fee_nursing_week": 1240,
      "la_occupancy_pct": 88.27,
      "la_residential_occupancy_pct": 87.8,
      "la_nursing_occupancy_pct": 89
    },
    "metric_details": {
      "la_avg_fee_residential_week": {
        "status": "available",
        "reason": null,
        "period": "2024-25",
        "source": "Local authority fee publications",
        "source_metadata": null,
        "reporting_authority": {
          "code": "E10000016",
          "name": "Kent",
          "kind": "ctyua"
        }
      },
      "la_avg_fee_nursing_week": {
        "status": "available",
        "reason": null,
        "period": "2024-25",
        "source": "Local authority fee publications",
        "source_metadata": null,
        "reporting_authority": {
          "code": "E10000016",
          "name": "Kent",
          "kind": "ctyua"
        }
      },
      "la_occupancy_pct": {
        "status": "available",
        "reason": null,
        "period": "2026-08-01",
        "source": "Capacity Tracker",
        "reporting_authority": {
          "code": "E10000016",
          "name": "Kent",
          "kind": "ctyua"
        }
      },
      "la_residential_occupancy_pct": {
        "status": "available",
        "reason": null,
        "period": "2026-08-01",
        "source": "Capacity Tracker",
        "reporting_authority": {
          "code": "E10000016",
          "name": "Kent",
          "kind": "ctyua"
        }
      },
      "la_nursing_occupancy_pct": {
        "status": "available",
        "reason": null,
        "period": "2026-08-01",
        "source": "Capacity Tracker",
        "reporting_authority": {
          "code": "E10000016",
          "name": "Kent",
          "kind": "ctyua"
        }
      }
    }
  },
  "credits": {
    "used": 5,
    "remaining": 979
  }
}

​

Reporting authority

A district normally resolves to its administrative parent county. A county or unitary code can be requested directly. requested_area retains the supplied area and authority identifies the resolved social-care authority. Every value’s details contain the actual reporting_authority; occupancy can use a further published reporting-area resolution.

​

Fees

la_avg_fee_residential_week and la_avg_fee_nursing_week each select their latest usable financial year. The two periods can differ. source_metadata preserves source-dependent fee-basis and funding evidence when available. Published tariffs, observed fees and Scottish national contract benchmarks are not automatically comparable. No funding basis should be inferred when detailed metadata is absent. Scottish national benchmarks, when present, retain their national source metadata rather than claiming to be council-specific observed averages.

​

Occupancy

la_occupancy_pct combines general/dementia residential and nursing beds, excluding specialist/other beds. The residential and nursing keys return the separate categories. Coverage is England only. Each category uses its latest published month across the source dataset; a missing or suppressed authority row in that month returns null with the reporting period. The API does not carry forward an older observation or substitute England’s value.

These are authority observations, not occupancy of a radius or an individual care home. No projection year or catchment size is accepted. An existing authority with no available data returns 200 with null values and reasons; an unknown code returns 404.

​

Credits

One credit is reserved per unique requested key and consumed only for each usable numeric value returned. Catalogue and geography-mapping endpoints are free.

Authorizations

Authorization · string · header · required

An API key created under Account > Catchment API. Keys start with ck_.

Query Parameters

code · string · required

ONS district, county or unitary authority code. Case and surrounding whitespace are normalized; an unknown authority returns 404.

Example:

"E07000110"

metrics · string · required

Comma-separated keys supporting local_authority. At most 50 distinct keys; duplicates and empty entries are removed.

Example:

"la_avg_fee_residential_week,la_avg_fee_nursing_week,la_occupancy_pct"

Response

200

application/json

Local-authority values, availability, periods and credit settlement.

request_id · string<uuid> · required

local_authority · object · required

Show child attributes

credits · object · required

Show child attributes