건설업 행정처분

1. 국토교통부 건설업 행정처분 조회opendata.kiscon.sanction

MCP 도구 이름 opendata__kiscon__sanction

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: sandbox

샌드박스입니다. 실제 기관을 호출하지 않는 모의 응답이며 일일 한도가 없습니다.

건설업체 공시 자료를 기간을 정해 훑고 사업자등록번호가 맞는 건을 골라냅니다.

Request

변수명	필수	설명
Authorization	Y	API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. 형식 : Basic base64("{client_id}:{client_secret}") [참고] 인증
X-Env-Scope	Y	호출 환경입니다. `sandbox`샌드박스 — 모의 응답 `real_test`데모 — 하루 100 사용 토큰 `production`정식 — 유료 플랜 전용 [참고] 환경
Idempotency-Key	Y	재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. [참고] 재시도
Content-Type	Y	요청 본문 형식입니다. `application/json`고정값 (기본값)
X-Trace-Id	N	추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.

변수명	타입	필수	설명
provider	string	Y	호출할 기관입니다. `opendata`이 API 고정값 (기본값) 예시 : opendata
action	string	Y	호출할 작업입니다. `opendata.kiscon.sanction`이 API 고정값 (기본값) 예시 : opendata.kiscon.sanction
params	object	Y	작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fields	object	N	민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. [참고] 암호화

변수명	타입	길이	필수	설명
bizno	string	-	Y	사업자등록번호 10자리. 조회 기간을 훑은 뒤 응답의 ncrMasterNum 과 대조한다
sDate	string	8	Y	공시 기간 시작일(기관 필수) 형식 : YYYYMMDD
eDate	string	8	Y	공시 기간 종료일(기관 필수) 형식 : YYYYMMDD
corp_name	string	-	N	업체명(선택) - 원본 행의 등록번호(ncrMasterNum)가 비어 있을 때 이름으로 대조한다(M2/M3 방식)
numOfRows	number	-	N	기관 페이지당 행 수(기본 100, 최대 100)
maxPages	number	-	N	훑을 최대 페이지 수(기본 5, 상한 20)
ncrAreaName	string	-	N	등록 시도 필터(선택)
ncrAreaDetailName	string	-	N	등록 시군구 필터(선택)

bash

curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: sandbox' \
  --header 'Idempotency-Key: demo-sanction-001' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "opendata",
  "action": "opendata.kiscon.sanction",
  "params": {
    "bizno": "<필수>",
    "sDate": "<필수>",
    "eDate": "<필수>"
  }
}'

Response

이 API 는 기관 응답 본문을 그대로 전달합니다. 고정 필드 목록이 없습니다.

json

{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "sandbox",
    "provider": "opendata",
    "action": "opendata.kiscon.sanction",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}