skills.rest
NomaDamas
NomaDamasOFFICIAL
Explore all skills by this author →
WebsiteGitHub

national-pension-workplace

Query Korean National Pension workplace enrollment data via the data.go.kr API through k-skill-proxy.

7.4k|904|Updated Mar 24, 2026
Search Tags:#api#Due diligence#korea#company lookup#data.go.kr#national pension#workplace enrollment
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill national-pension-workplace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: national-pension-workplace
Source: https://github.com/NomaDamas/k-skill/tree/main/national-pension-workplace
Command: npx skills add https://github.com/NomaDamas/k-skill --skill national-pension-workplace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Checking a Korean company's workforce size and hiring trends normally requires manual searching on the public data portal; this Skill retrieves National Pension workplace enrollment records programmatically so you can gauge headcount, monthly billed pension amounts, and monthly join/leave trends from a company name.

Core Features & Use Cases

  • Workplace Candidate Lookup: Match workplaces by business name plus the first 6 digits of the business registration number, returning the latest record per workplace.
  • Enrollment Detail Retrieval: For an identified workplace, fetch subscriber count (jnngpCnt), current-month billed amount (crrmmNtcAmt), and new acquisition/loss counts.
  • Monthly Trend Series: Retrieve month-by-month enrollment history to see whether headcount is growing or shrinking.
  • Use Case: Before joining a company or signing a vendor contract, ask for its National Pension subscriber count and monthly trend to verify its actual scale and stability.

Quick Start

Ask the agent to look up the National Pension enrollment for a company by name, for example: "Check the National Pension subscriber count and monthly trend for 삼성전자(주) with business number 124-81-00998."

Frequently Asked Questions about national-pension-workplace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check a Korean company's employee count using National Pension data?▼

Run the helper script with the company name via --name, optionally adding --b-no with the 10-digit business registration number. The response returns the subscriber count (jnngpCnt), current-month billed amount, and monthly acquisition/loss figures.

Do I need an API key to query the data.go.kr National Pension API?▼

No user-side key is required. The k-skill-proxy server holds DATA_GO_KR_API_KEY, so you only need network access to the hosted proxy at k-skill-proxy.nomadamas.org or a self-hosted proxy set via KSKILL_PROXY_BASE_URL.

Why does the lookup return multiple workplace candidates instead of one result?▼

The API only exposes the first 6 digits of business registration numbers, so name-based matching can yield several candidates. In that case selected_candidate is null and the user must pick the correct workplace from the returned list.

What does a 503 upstream_not_configured error mean for this API?▼

It means the k-skill-proxy server has no DATA_GO_KR_API_KEY configured. Contact the proxy operator, or self-host the proxy with a data.go.kr key that has an approved usage application for service 3046071.

Can I look up small or individual businesses with this National Pension API?▼

Coverage is limited to workplaces the National Pension Service officially publishes, mainly corporations and larger employers. Small or individual businesses may not be disclosed, and individual workers' personal data is never exposed.

Related Skills

Explore More Data & Analytics Skills→
AradotsoAradotso
70

brreg

Search and retrieve Norwegian company data from the Brønnøysundregistrene API.

Official
Intermediate
abhishek2chikunabhishek2chikun

due-diligence

Structure business due diligence analysis across commercial, financial, operational, and technology domains.

Community
Advanced
athina-aiathina-ai
1.1k

expansion-signal-spotter

Monitor customer accounts for upsell and cross-sell signals and generate prioritized expansion opportunities.

Official
Advanced
patriotnewsactivismpatriotnewsactivism
2

find-customers

Identify and qualify B2B leads by defining Ideal Customer Profiles and analyzing trigger events.

Community
Advanced