개발자 문서
API 레퍼런스

사업자등록 - 공공데이터 기업 위험 조회

이 쪽의 모든 작업에 해당

  • 이 API 는 기관 연동과 기관 로그인이 필요 없습니다. 기관 자격증명을 등록하지 않아도 호출할 수 있고, account_link_id 는 보내지 않습니다.

1. 국세청 사업자등록 상태 조회opendata.nts.status

MCP 도구 이름 opendata__nts__status

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

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

사업자등록번호로 휴업과 폐업 여부, 과세유형을 국세청 자료에서 조회합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입필수설명
providerstringY호출할 기관입니다.
  • opendata이 API 고정값 (기본값)

예시 : opendata

actionstringY호출할 작업입니다.
  • opendata.nts.status이 API 고정값 (기본값)

예시 : opendata.nts.status

paramsobjectY작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobjectN민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
b_noarrayY사업자등록번호 목록 - 각 10자리 숫자(예: ["1248100998"]). 최대 100건
output_formatsarrayN이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다
  • 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: status-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "opendata",
  "action": "opendata.nts.status",
  "params": {
    "b_no": "<필수: array>"
  }
}'

Response

순번변수명타입설명
source_idstring이 작업의 원천 데이터셋 번호입니다. 이 작업에서는 항상 15081808 입니다(공공데이터포털 data.go.kr 의 번호).
actionstring호출한 작업 이름입니다. 이 작업에서는 항상 opendata.nts.status 입니다.
job_idstring이 결과를 만든 작업의 ID 입니다.
sourceobject원천의 출처 정보입니다. 결과를 사용자에게 보여 줄 때 출처 표시에 씁니다.
source.idstring원천 데이터셋 번호입니다. source_id 와 같은 값입니다.
source.orgstring원천 데이터를 제공하는 기관 이름입니다. 이 작업에서는 항상 국세청 입니다.
source.licensestring원천 데이터의 이용 허락 범위 표기입니다. 값은 원천마다 다르고, 결과를 보여 줄 때 출처 표시와 함께 씁니다.
license_notesarray출처 표시 문구, 이용 허락 표기, 결과 해석 안내가 이 순서로 담긴 문장 목록입니다. 첫 줄은 「출처: 국세청 사업자등록 상태 / data.go.kr 15081808」 입니다.
upstreamobject국세청 사업자등록정보 진위확인 및 상태조회 서비스의 응답을 담습니다. 응답의 칸은 바꾸지 않고, data 의 행마다 crno, corp_name_norm 칸만 더합니다. 아래 칸은 그 서비스 명세가 정한 응답 칸과 더한 칸이고, 국세청이 칸을 더하면 그 칸도 그대로 옵니다.
upstream.status_codestring국세청 서비스가 알려 주는 처리 결과 코드입니다. OK 가 아닌 코드가 오면 작업이 실패로 끝나므로, 성공한 결과에서는 OK 입니다.
upstream.match_cntnumber국세청에 등록되어 상태가 조회된 사업자등록번호의 수입니다. 조회된 번호가 하나도 없으면 이 칸이 오지 않을 수 있습니다.
upstream.request_cntnumber조회를 요청한 사업자등록번호의 수입니다.
upstream.dataarray요청한 사업자등록번호마다 한 행씩 담긴 목록입니다.
upstream.data[].b_nostring사업자등록번호입니다(숫자 10자리).
upstream.data[].b_sttstring사업자등록 상태의 이름입니다. 「계속사업자」, 「휴업자」, 「폐업자」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
upstream.data[].b_stt_cdstring사업자등록 상태의 코드입니다. 01 「계속사업자」, 02 「휴업자」, 03 「폐업자」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
upstream.data[].tax_typestring과세유형의 이름입니다. 「부가가치세 일반과세자」, 「부가가치세 간이과세자」, 「부가가치세 과세특례자」, 「부가가치세 면세사업자」, 「수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등」, 「고유번호가 부여된 단체」, 「부가가치세 간이과세자(세금계산서 발급사업자)」 가운데 하나입니다. 국세청에 등록되지 않았거나 삭제된 번호이면 「국세청에 등록되지 않은 사업자등록번호입니다」 와 같은 뜻의 안내 문장이 옵니다.
upstream.data[].tax_type_cdstring과세유형의 코드입니다. 01 「부가가치세 일반과세자」, 02 「부가가치세 간이과세자」, 03 「부가가치세 과세특례자」, 04 「부가가치세 면세사업자」, 05 「수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등」, 06 「고유번호가 부여된 단체」, 07 「부가가치세 간이과세자(세금계산서 발급사업자)」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
upstream.data[].end_dtstring폐업일자입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다.
upstream.data[].utcc_ynstring단위과세 전환으로 폐업했는지를 나타내는 값입니다(Y 또는 N). 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
upstream.data[].tax_type_change_dtstring가장 최근에 과세유형이 바뀐 날짜입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다.
upstream.data[].invoice_apply_dtstring세금계산서 적용일자입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다.
upstream.data[].rbf_tax_typestring직전 과세유형의 이름입니다. 「부가가치세 일반과세자」, 「부가가치세 간이과세자」, 「부가가치세 간이과세자(세금계산서 발급사업자)」, 「해당없음」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
upstream.data[].rbf_tax_type_cdstring직전 과세유형의 코드입니다. 01 「부가가치세 일반과세자」, 02 「부가가치세 간이과세자」, 07 「부가가치세 간이과세자(세금계산서 발급사업자)」, 99 「해당없음」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
upstream.data[].crnostring | null법인등록번호입니다. 국세청 응답에 없는 칸으로, 다른 조회를 하며 모아 둔 식별자 색인에서 이 행의 사업자등록번호로 찾아 붙입니다. 색인에 그 번호가 없거나, 색인의 그 기록이 유효 기한을 넘겼거나, 색인을 읽지 못했으면 null 이고 상태 조회 결과는 그대로 옵니다.
upstream.data[].corp_name_normstring | null법인명입니다. 국세청 응답에 없는 칸으로, 다른 조회를 하며 모아 둔 식별자 색인에서 이 행의 사업자등록번호로 찾아 붙입니다. 색인에 그 번호가 없거나, 색인의 그 기록이 유효 기한을 넘겼거나, 색인을 읽지 못했으면 null 이고 상태 조회 결과는 그대로 옵니다.
json
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
  "source_id": "<string>",
  "action": "<string>",
  "job_id": "<string>",
  "source": {
    "id": "<string>",
    "org": "<string>",
    "license": "<string>"
  },
  "license_notes": [],
  "upstream": {
    "status_code": "<string>",
    "match_cnt": "<number>",
    "request_cnt": "<number>",
    "data": [
      {
        "b_no": "<string>",
        "b_stt": "<string>",
        "b_stt_cd": "<string>",
        "tax_type": "<string>",
        "tax_type_cd": "<string>",
        "end_dt": "<string>",
        "utcc_yn": "<string>",
        "tax_type_change_dt": "<string>",
        "invoice_apply_dt": "<string>",
        "rbf_tax_type": "<string>",
        "rbf_tax_type_cd": "<string>",
        "crno": "<string | null>",
        "corp_name_norm": "<string | null>"
      }
    ]
  }
}
순번오류 코드발생 조건
POLICY_QUOTA_EXCEEDED공공데이터 조회의 하루 한도를 모두 쓰면 작업이 이 오류로 끝납니다. error.message 는 「오늘 이 조직의 공공데이터 조회 한도를 모두 썼습니다. 한국시간 자정에 다시 열립니다. 한도 상향이 필요하면 서비스문의로 알려 주세요.」 꼴이고, 한도의 범위에 따라 「이 조직의」 대신 「무료 요금제 몫의」 나 「서비스 전체」 가 들어갑니다. 자정이 지난 뒤에 다시 요청합니다.
PROVIDER_UPSTREAM_ERROR공공데이터 제공처가 오류로 답하면 작업이 이 오류로 끝나고, error.message 는 응답 상태로 고릅니다. 429 이면 「요청이 잠시 제한되었습니다. 잠시 후 다시 시도해 주세요.」, 500번대이면 「일시적인 오류로 요청을 마치지 못했습니다. 잠시 후 다시 시도해 주세요.」, 401 과 403 을 뺀 400번대이면 「요청을 처리할 수 없습니다. 입력한 값을 다시 확인해 주세요.」 입니다(401 과 403, 그리고 제공처가 인증키나 접근 권한을 거절한 응답은 이 오류가 아니라 INTERNAL_ERROR 로 끝납니다). 응답은 받았는데 읽지 못했거나 상태를 알 수 없으면 「기관에서 받은 응답을 처리하지 못했습니다. 잠시 후 다시 시도해 주시고, 계속되면 서비스문의로 알려 주세요.」 가 오고, 상태가 400번대도 500번대도 아니면 「일시적인 오류로 요청을 마치지 못했습니다. 잠시 후 다시 시도해 주세요.」 가 옵니다.
VALIDATION_INVALID_FIELD요청 값이 맞지 않으면 작업이 이 오류로 끝나고, 요청을 고쳐 다시 요청합니다. 값이 빠지면 error.message 는 「요청에 필요한 값이 빠졌습니다. 빠진 값: 칸 이름. 그 값을 넣어 다시 요청해 주세요.」 꼴이고, 값의 형식이 틀리면 「요청 값이 올바르지 않습니다. 확인할 값: 칸 이름. 값을 고쳐 다시 요청해 주세요.」 꼴입니다(칸 이름이 다섯을 넘으면 앞 다섯과 「외 N개」 를 적습니다). 지원하지 않는 작업을 부르면 「지원하지 않는 작업입니다.」 입니다.
INTERNAL_ERRORXBOSS 쪽 설정이나 처리 결함으로 끝나면 이 오류가 나가고 error.message 는 「서버 내부 오류로 작업을 마치지 못했습니다. 서비스문의로 알려 주세요.」 입니다. 고객이 고칠 값이 없으므로 잠시 뒤 다시 요청하고, 계속되면 서비스문의로 알려 주세요. 공공데이터 제공처가 XBOSS 의 이용 권한을 받아들이지 않을 때(응답 상태 401 이나 403, 또는 인증키나 접근 권한을 거절한 응답)도 이 오류이고 error.message 는 「조회 서비스를 이용할 수 없습니다. 서비스문의로 연결 상태 확인을 요청해 주세요.」 입니다. 다시 요청해도 같은 결과이므로 서비스문의로 알려 주세요.

2. 국세청 사업자등록 진위 확인opendata.nts.validate

MCP 도구 이름 opendata__nts__validate

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

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

사업자등록번호와 개업일자, 대표자명이 국세청 자료와 맞는지 대조합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입필수설명
providerstringY호출할 기관입니다.
  • opendata이 API 고정값 (기본값)

예시 : opendata

actionstringY호출할 작업입니다.
  • opendata.nts.validate이 API 고정값 (기본값)

예시 : opendata.nts.validate

paramsobjectY작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobjectN민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

  • 대괄호 []는 목록의 각 항목을, 점은 객체의 속성을, {key}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
순번변수명타입길이필수설명
businessesarray-Y진위 확인 대상 사업자 목록. 항목마다 b_no, start_dt(YYYYMMDD), p_nm 이 필수. 최대 100개
businesses[].b_nostring-Y사업자등록번호(10자리 숫자)
businesses[].start_dtstring8Y개업일자

형식 : YYYYMMDD

businesses[].p_nmstring-Y대표자 성명
businesses[].p_nm2string-N대표자 한글명(선택). 대표자성명(p_nm)이 외국인 영문명일 때만 그 한글명을 넣습니다. 공동대표자명이 아니며, 내국인은 비웁니다
businesses[].b_nmstring-N상호
businesses[].corp_nostring-N법인등록번호
businesses[].b_sectorstring-N업태
businesses[].b_typestring-N종목
  • 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: validate-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "opendata",
  "action": "opendata.nts.validate",
  "params": {
    "businesses": [
      {
        "b_no": "<필수>",
        "start_dt": "<필수>",
        "p_nm": "<필수>"
      }
    ]
  }
}'

Response

순번변수명타입설명
source_idstring이 작업의 원천 데이터셋 번호입니다. 이 작업에서는 항상 15081808 입니다(공공데이터포털 data.go.kr 의 번호).
actionstring호출한 작업 이름입니다. 이 작업에서는 항상 opendata.nts.validate 입니다.
job_idstring이 결과를 만든 작업의 ID 입니다.
sourceobject원천의 출처 정보입니다. 결과를 사용자에게 보여 줄 때 출처 표시에 씁니다.
source.idstring원천 데이터셋 번호입니다. source_id 와 같은 값입니다.
source.orgstring원천 데이터를 제공하는 기관 이름입니다. 이 작업에서는 항상 국세청 입니다.
source.licensestring원천 데이터의 이용 허락 범위 표기입니다. 값은 원천마다 다르고, 결과를 보여 줄 때 출처 표시와 함께 씁니다.
license_notesarray출처 표시 문구, 이용 허락 표기, 결과 해석 안내가 이 순서로 담긴 문장 목록입니다. 첫 줄은 「출처: 국세청 사업자등록 진위 / data.go.kr 15081808」 입니다.
upstreamobject국세청 사업자등록정보 진위확인 및 상태조회 서비스의 응답을 가공하지 않고 그대로 담습니다. 아래 칸은 그 서비스 명세가 정한 응답 칸이고, 국세청이 칸을 더하면 그 칸도 그대로 옵니다.
upstream.status_codestring국세청 서비스가 알려 주는 처리 결과 코드입니다. OK 가 아닌 코드가 오면 작업이 실패로 끝나므로, 성공한 결과에서는 OK 입니다.
upstream.request_cntnumber진위 확인을 요청한 사업자 정보의 수입니다.
upstream.valid_cntnumber요청한 사업자 정보 가운데 국세청 자료와 일치한 건수입니다. 일치한 건이 하나도 없으면 이 칸이 오지 않을 수 있습니다.
upstream.dataarray요청한 사업자 정보마다 한 행씩 담긴 목록입니다.
upstream.data[].b_nostring요청한 사업자등록번호입니다.
upstream.data[].validstring진위 확인 결과 코드입니다. 01 이면 국세청 자료와 일치하고 02 이면 일치하지 않습니다.
upstream.data[].valid_msgstring일치하지 않을 때(valid 가 02) 오는 안내 문장으로, 국세청 자료에서 확인할 수 없다는 뜻입니다. 일치할 때는 이 칸이 오지 않습니다.
upstream.data[].request_paramobject요청에 담아 보낸 사업자 정보 한 건입니다. 요청의 params.businesses[] 한 항목과 같은 칸입니다.
upstream.data[].statusobject일치한 사업자의 국세청 상태입니다. 안쪽 칸은 사업자 상태조회(opendata.nts.status)의 upstream.data[] 행과 같습니다. 일치하지 않으면 이 칸이 오지 않을 수 있습니다.
upstream.data[].status.b_nostring사업자등록번호입니다(숫자 10자리).
upstream.data[].status.b_sttstring사업자등록 상태의 이름입니다. 「계속사업자」, 「휴업자」, 「폐업자」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
upstream.data[].status.b_stt_cdstring사업자등록 상태의 코드입니다. 01 「계속사업자」, 02 「휴업자」, 03 「폐업자」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
upstream.data[].status.tax_typestring과세유형의 이름입니다. 「부가가치세 일반과세자」, 「부가가치세 간이과세자」, 「부가가치세 과세특례자」, 「부가가치세 면세사업자」, 「수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등」, 「고유번호가 부여된 단체」, 「부가가치세 간이과세자(세금계산서 발급사업자)」 가운데 하나입니다. 국세청에 등록되지 않았거나 삭제된 번호이면 「국세청에 등록되지 않은 사업자등록번호입니다」 와 같은 뜻의 안내 문장이 옵니다.
upstream.data[].status.tax_type_cdstring과세유형의 코드입니다. 01 「부가가치세 일반과세자」, 02 「부가가치세 간이과세자」, 03 「부가가치세 과세특례자」, 04 「부가가치세 면세사업자」, 05 「수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등」, 06 「고유번호가 부여된 단체」, 07 「부가가치세 간이과세자(세금계산서 발급사업자)」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
upstream.data[].status.end_dtstring폐업일자입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다.
upstream.data[].status.utcc_ynstring단위과세 전환으로 폐업했는지를 나타내는 값입니다(Y 또는 N). 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
upstream.data[].status.tax_type_change_dtstring가장 최근에 과세유형이 바뀐 날짜입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다.
upstream.data[].status.invoice_apply_dtstring세금계산서 적용일자입니다(YYYYMMDD). 값이 없으면 빈 문자열입니다.
upstream.data[].status.rbf_tax_typestring직전 과세유형의 이름입니다. 「부가가치세 일반과세자」, 「부가가치세 간이과세자」, 「부가가치세 간이과세자(세금계산서 발급사업자)」, 「해당없음」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
upstream.data[].status.rbf_tax_type_cdstring직전 과세유형의 코드입니다. 01 「부가가치세 일반과세자」, 02 「부가가치세 간이과세자」, 07 「부가가치세 간이과세자(세금계산서 발급사업자)」, 99 「해당없음」 가운데 하나이고, 국세청에 등록되지 않은 번호이면 빈 문자열입니다.
json
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
  "source_id": "<string>",
  "action": "<string>",
  "job_id": "<string>",
  "source": {
    "id": "<string>",
    "org": "<string>",
    "license": "<string>"
  },
  "license_notes": [],
  "upstream": {
    "status_code": "<string>",
    "request_cnt": "<number>",
    "valid_cnt": "<number>",
    "data": [
      {
        "b_no": "<string>",
        "valid": "<string>",
        "valid_msg": "<string>",
        "request_param": {},
        "status": {
          "b_no": "<string>",
          "b_stt": "<string>",
          "b_stt_cd": "<string>",
          "tax_type": "<string>",
          "tax_type_cd": "<string>",
          "end_dt": "<string>",
          "utcc_yn": "<string>",
          "tax_type_change_dt": "<string>",
          "invoice_apply_dt": "<string>",
          "rbf_tax_type": "<string>",
          "rbf_tax_type_cd": "<string>"
        }
      }
    ]
  }
}
순번오류 코드발생 조건
POLICY_QUOTA_EXCEEDED공공데이터 조회의 하루 한도를 모두 쓰면 작업이 이 오류로 끝납니다. error.message 는 「오늘 이 조직의 공공데이터 조회 한도를 모두 썼습니다. 한국시간 자정에 다시 열립니다. 한도 상향이 필요하면 서비스문의로 알려 주세요.」 꼴이고, 한도의 범위에 따라 「이 조직의」 대신 「무료 요금제 몫의」 나 「서비스 전체」 가 들어갑니다. 자정이 지난 뒤에 다시 요청합니다.
PROVIDER_UPSTREAM_ERROR공공데이터 제공처가 오류로 답하면 작업이 이 오류로 끝나고, error.message 는 응답 상태로 고릅니다. 429 이면 「요청이 잠시 제한되었습니다. 잠시 후 다시 시도해 주세요.」, 500번대이면 「일시적인 오류로 요청을 마치지 못했습니다. 잠시 후 다시 시도해 주세요.」, 401 과 403 을 뺀 400번대이면 「요청을 처리할 수 없습니다. 입력한 값을 다시 확인해 주세요.」 입니다(401 과 403, 그리고 제공처가 인증키나 접근 권한을 거절한 응답은 이 오류가 아니라 INTERNAL_ERROR 로 끝납니다). 응답은 받았는데 읽지 못했거나 상태를 알 수 없으면 「기관에서 받은 응답을 처리하지 못했습니다. 잠시 후 다시 시도해 주시고, 계속되면 서비스문의로 알려 주세요.」 가 오고, 상태가 400번대도 500번대도 아니면 「일시적인 오류로 요청을 마치지 못했습니다. 잠시 후 다시 시도해 주세요.」 가 옵니다.
VALIDATION_INVALID_FIELD요청 값이 맞지 않으면 작업이 이 오류로 끝나고, 요청을 고쳐 다시 요청합니다. 값이 빠지면 error.message 는 「요청에 필요한 값이 빠졌습니다. 빠진 값: 칸 이름. 그 값을 넣어 다시 요청해 주세요.」 꼴이고, 값의 형식이 틀리면 「요청 값이 올바르지 않습니다. 확인할 값: 칸 이름. 값을 고쳐 다시 요청해 주세요.」 꼴입니다(칸 이름이 다섯을 넘으면 앞 다섯과 「외 N개」 를 적습니다). 지원하지 않는 작업을 부르면 「지원하지 않는 작업입니다.」 입니다.
INTERNAL_ERRORXBOSS 쪽 설정이나 처리 결함으로 끝나면 이 오류가 나가고 error.message 는 「서버 내부 오류로 작업을 마치지 못했습니다. 서비스문의로 알려 주세요.」 입니다. 고객이 고칠 값이 없으므로 잠시 뒤 다시 요청하고, 계속되면 서비스문의로 알려 주세요. 공공데이터 제공처가 XBOSS 의 이용 권한을 받아들이지 않을 때(응답 상태 401 이나 403, 또는 인증키나 접근 권한을 거절한 응답)도 이 오류이고 error.message 는 「조회 서비스를 이용할 수 없습니다. 서비스문의로 연결 상태 확인을 요청해 주세요.」 입니다. 다시 요청해도 같은 결과이므로 서비스문의로 알려 주세요.