MOLIT Apartment Complex Basic Information Service
Official MOLIT basic and detailed information for apartment complexes (K-apt member complexes). Call directly with GET /api/apt?kaptCode=A... with no auth key (complex code required; detail=1 returns detailed info). The server already has a data.go.kr key registered, so calls work immediately. Provides complex name, legal-district and road-name addresses, sales type, heating, unit count, builder, management, elevators, parking, CCTV, and transit and amenity info.
⚡ Apartment complex basic/detail quick call
GET /api/apt?kaptCode=A10025972&detail=0
Use this URL first when complex info is needed. No auth key required; kaptCode (complex code) is required; detail=1 returns detailed info. Server key already registered, so calls work immediately.
What agents get
- Complex name (kaptName), legal-district and road-name addresses and legal-district code, sales/heating/management/corridor types, building/household/unit counts, total floor area, top floor, builder and developer, management-office phone/fax/homepage, approval date, unit counts by exclusive area, elevators, ground/underground parking, CCTV, EV chargers, bus/subway access, convenience and education facilities, and shared amenities
Complex basic-info lookup, management and amenity checks, complex analysis combined with actual prices (rtms-apt-trade), and support for moving and investment decisions
Use cases
- Look up apartment basics by complex code
- Check management method, staff, and contractors
- Check parking, elevators, CCTV, and amenities
- Complex-level price analysis combined with actual transactions
Registered APIs (2)
Apartment Complex Basic Info Lookup getAphusBassInfoV5
Look up 31 basic fields by complex code. A nonexistent code returns resultCode 00 with all fields null, so treat a null kaptCode as no record
kaptCodeRequired — Complex code (K-apt complex code, A followed by digits) e.g.A10025972numOfRowsOptional e.g.10pageNoOptional e.g.1dataTypeOptional e.g.JSON
Returns: kaptCode/kaptName (complex code/name), kaptAddr (legal-district address), doroJuso (road-name address), bjdCode (legal-district code), codeSaleNm (sales type), codeHeatNm (heating type), codeMgrNm (management type), codeHallNm (corridor type), kaptDongCnt (buildings), kaptdaCnt (households), hoCnt (units), kaptTarea (total floor area), kaptBcompany (builder), kaptAcompany (developer), kaptTel/kaptFax (management office phone/fax), kaptUrl (homepage), kaptUsedate (approval date), kaptTopFloor (top floor), kaptMparea60/85/135/136 (units by exclusive area), privArea (total exclusive area)
Rate limit: 1,000 calls/day (data.go.kr daily limit of 1,000 calls)
Apartment Complex Detail Info Lookup getAphusDtlInfoV5
36 fields for management, facilities, and transit/amenities. Type caution: some numeric fields may arrive as strings. Top floor comes in two variants: kaptTopFloor and ktownFlrNo (building register)
kaptCodeRequired — Complex code (K-apt complex code, A followed by digits) e.g.A10025972numOfRowsOptional e.g.10pageNoOptional e.g.1dataTypeOptional e.g.JSON
Returns: codeMgr/kaptMgrCnt/kaptCcompany (general management method, staff, contractor), codeSec/kaptdScnt/kaptdSecCom (security management method, staff, contractor), codeClean/kaptdClcnt (cleaning), codeGarbage (food-waste handling), codeDisinf (disinfection), codeStr (building structure), codeEcon (electricity contract type), codeWsupply (water supply type), kaptdEcnt (elevators), kaptdPcnt/underground parking, kaptdCccnt (CCTV), ground/underground EV charger counts, kaptdWtimebus (distance to bus stop), subwayLine/subwayStation (subway), convenientFacility (amenities), educationFacility (schools), welfareFacility (shared amenities)
Rate limit: 1,000 calls/day
Auth · pricing · terms
| Auth | ServiceKey — data.go.kr service key. Stored only on the proxy server and never exposed to agents. Agents call only our quick API (/api/apt) or the X-Agent-Token proxy. |
|---|---|
| Pricing | Free. Auto-approved |
| License | Public data: attribution required (Type 1) |
| Redistribution | Allowed (attribution required) |
| Terms checked | 2026-10-13 |
| Apply | Log in to data.go.kr -> Apply for the MOLIT_Apartment Complex Basic Information Service -> Service key issued (auto-approved) Portal |
| Status | Active |
| Last checked | 2026-10-13 |
How agents call
Call through our proxy. Start with the keyless quick API shown above (no token needed). For the keyed proxy, send X-Agent-Token to POST /agencatalog/api/call with ('service', 'endpoint', 'params'). The full service list is at /agencatalog/api/services.json.
Example: POST /agencatalog/api/call {service:'molit-apt-basis-info', endpoint:'getAphusBassInfoV5', params:{kaptCode:'A10025972'}}
Machine-readable JSON schema
{
"service": "molit-apt-basis-info",
"name": "MOLIT Apartment Complex Basic Information Service",
"provider": "MOLIT",
"apis": [
{
"id": "getAphusBassInfoV5",
"name": "Apartment Complex Basic Info Lookup",
"params": [
{
"name": "kaptCode",
"required": true,
"example": "A10025972",
"desc": "Complex code (K-apt complex code, A followed by digits)"
},
{
"name": "numOfRows",
"required": false,
"example": "10"
},
{
"name": "pageNo",
"required": false,
"example": "1"
},
{
"name": "dataType",
"required": false,
"example": "JSON"
}
]
},
{
"id": "getAphusDtlInfoV5",
"name": "Apartment Complex Detail Info Lookup",
"params": [
{
"name": "kaptCode",
"required": true,
"example": "A10025972",
"desc": "Complex code (K-apt complex code, A followed by digits)"
},
{
"name": "numOfRows",
"required": false,
"example": "10"
},
{
"name": "pageNo",
"required": false,
"example": "1"
},
{
"name": "dataType",
"required": false,
"example": "JSON"
}
]
}
],
"proxy_call": "POST /agencatalog/api/call",
"attribution": "Source: MOLIT Apartment Complex Basic Information Service (Public Data Portal data.go.kr)"
}
Notes
- API keys live only on the server. Clients asking for keys directly cannot use this route.
- Each provider has a daily quota. Over-quota calls return 429 and are blocked.
- Provider outages or over-quota errors are passed through. Check the error field before retrying.
- Attribution: Source: MOLIT Apartment Complex Basic Information Service (Public Data Portal data.go.kr)
Last checked: 2026-10-13
AI Knowledge Hub