GET /companies/{brn}/employment

Month-by-month National Pension subscriber counts. 10 credits; a company without a series returns 404 no_series and costs 0.

Month-by-month National Pension subscriber counts. 10 credits; a company without a series costs 0.

Every company record says whether this call will return anything — employment_series is true or false. Check it before spending 10 credits, or filter a search with has=pension_series. A company without a series returns 404 no_series and costs 0.

Do not use nps_latest for this. That field is the most recent month we observed, so it is absent for a company whose records stop earlier — 13,099 companies have a series but no latest-month figure.

curl -H "Authorization: Bearer $KCID_KEY" \
  ".../companies/1248100998/employment"

{
  "brn": "1248100998",
  "source": "National Pension Service",
  "unit": "subscribers",
  "observed_periods": 36,
  "series": [
    { "period": "2026-07", "subscribers": 125592,
      "new_acquisitions": 1103, "separations": 894,
      "worksites_matched": 1, "worksites_total": 6,
      "aggregation_quality": "clean" }
  ]
}

worksites_matched against worksites_total tells you how much of the company the number covers. Read it before you trust the level — when the two differ, the month-to-month change holds up better than the absolute level.

Missing an endpoint or a field? Say what you were trying to do — it is read by the person who builds this.