apipick
[ 검증 · 세무 ]● 3 크레딧 · 분당 20회

EU VAT 번호 검증 API

유럽연합 집행위원회의 공식 등록부 VIES에 조회해 EU 부가가치세 번호를 검증합니다. 실시간 확인과 함께, 회원국이 공개하는 경우 등록된 법인명과 주소도 반환합니다.

공식 VIES 출처27개국 + XI실시간 조회
auth · x-api-key

API 키가 없으신가요?

계정에 로그인하여 API 키를 생성하고 관리하세요.

로그인API 키 관리
[ 02 · integrate ]

통합 가이드

스니펫을 복사하고 API 키를 교체한 뒤 실행하세요. 모든 HTTP 클라이언트에서 작동합니다 — 아래에 cURL, JavaScript, Python 예제가 있습니다.

spec
GET/api/validate-vat
base
https://www.apipick.com

Validate an EU VAT number against the official VIES registry

매개변수
vat_numberstring필수

Full VAT number with its two-letter member-state prefix. Spaces, dots, and hyphens are stripped. IE6388047V

countrystring선택

Member-state code, if the number is supplied without its prefix. Greece is EL, not GR. IE

curl -X GET "https://www.apipick.com/api/validate-vat" \
  -H "x-api-key: YOUR_API_KEY"
● 200 · 응답
{
  "vat_number": "IE6388047V",
  "country_code": "IE",
  "number": "6388047V",
  "valid": true,
  "name": "GOOGLE IRELAND LIMITED",
  "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
  "name_disclosed": true,
  "request_date": "2026-09-01T11:52:22.440Z",
  "consultation_number": null,
  "source": "European Commission VIES",
  "credits_used": 3,
  "remaining_credits": 97
}

실전 활용 사례를 위해 제작

🧾

리버스 차지 청구

국경 간 B2B 청구서에 영세율을 적용하기 전에 구매자의 VAT 등록을 확인하고 그 조회 기록을 남기세요.

🚪

B2B 온보딩

가입 시점에 검증하고, 고객에게 입력을 요구하는 대신 등록부의 법인명과 주소를 자동으로 채우세요.

🛡️

사기 방지

허위이거나 만료된 VAT 번호가 청구 시스템이나 세무 신고에 도달하기 전에 걸러내세요.

🤖

에이전트 워크플로

청구서를 처리하는 도중 호출할 수 있는 단일 매개변수 도구를 재무 에이전트에게 제공하고, 모호하지 않은 불리언 답을 받으세요.

응답 필드

필드타입설명
validboolean해당 번호가 현재 국경 간 거래용으로 등록되어 있는지 여부
country_codestring신고상 회원국 코드 (그리스는 EL, 북아일랜드는 XI)
numberstring국가 접두사를 제외한 VAT 번호 본체
namestring | null등록된 사업자명 (회원국이 공개하는 경우)
addressstring | null등록된 주소 (회원국이 공개하는 경우)
name_disclosedboolean회원국이 방침상 신원 항목을 비공개할 때 false (독일, 스페인)
request_datestring | nullVIES가 이 조회에 기록한 타임스탬프
consultation_numberstring | nullVIES 조회 식별자로, 검증했다는 증빙으로 사용할 수 있습니다
credits_usedinteger이 요청으로 차감된 크레딧
remaining_creditsinteger계정에 남은 크레딧
[ 03 · limits ]

요청 제한

스로틀링은 API 키 단위, 60초 슬라이딩 윈도우입니다. 한도에 도달하면 Retry-After 헤더가 포함된 깔끔한 429를 받습니다.

요청 속도

20req/min

API 키별, 엔드포인트별. 60초 슬라이딩 윈도우.

동시성

3concurrent

API 키당 동시에 처리 중인 최대 요청 수.

응답 헤더
X-RateLimit-Limit분당 허용되는 최대 요청 수
X-RateLimit-Remaining현재 윈도우에 남은 요청 수
X-RateLimit-Reset현재 윈도우가 초기화되기까지의 초
Retry-After재시도 전 대기 초 (429일 때만)
● 429 · 요청이 너무 많음
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 20 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

데이터 출처 및 라이선스

조회는 유럽연합 집행위원회의 부가가치세 정보 교환 시스템 VIES를 통해 이루어지며, VIES는 각 요청을 해당 회원국 자체 세무 데이터베이스로 실시간 전달합니다. 저희는 등록부 사본을 전혀 보관하지 않습니다. 답변은 세무 당국의 것이며, 저희는 장애 상황과 비공개 사례를 명시해 깔끔한 JSON으로 전달할 뿐입니다.

자주 묻는 질문

Q: 이것이 EU 공식 조회인가요?

A: 네. 요청은 유럽연합 집행위원회의 부가가치세 정보 교환 시스템 VIES로 전송되며, VIES가 해당 회원국 자체 세무 데이터베이스를 실시간으로 조회합니다. 중간 데이터베이스가 없으므로 여기서의 결과는 집행위원회 웹 양식에서 얻는 것과 일치합니다.

Q: 독일 번호는 왜 사업자명이 비어 있나요?

A: 독일과 스페인은 방침상 VIES를 통해 사업자명과 주소를 공개하지 않습니다. 번호의 등록 여부는 그대로 확인되며 신원 항목만 비공개됩니다. 응답에 name_disclosed: false가 설정되므로 방침에 따른 비공개와 실제로 값이 없는 경우를 구분할 수 있습니다.

Q: 회원국 시스템이 중단되면 어떻게 되나요?

A: VIES는 각 회원국 자체 데이터베이스로 요청을 전달하는데, 이들은 유지보수로 오프라인이 되기도 합니다. 그럴 때는 명확한 메시지와 함께 HTTP 503이 반환되고 크레딧은 차감되지 않습니다. 몇 분 뒤 다시 시도하세요. 장애는 세무 당국 쪽에 있으며 저희 쪽이 아닙니다.

Q: 어떤 국가 코드를 지원하나요?

A: 27개 회원국 전체와 윈저 프레임워크에 따른 북아일랜드 XI를 지원합니다. 그리스는 ISO 코드 GR이 아니라 EL로 VAT를 신고한다는 점에 유의하세요. 영국 본토(GB)는 브렉시트 이후 VIES에서 빠져 지원 대상이 아닙니다.

Q: 감사 추적용 조회 번호를 받을 수 있나요?

A: VIES가 조회 식별자를 발급하면 consultation_number 필드에 담겨 반환됩니다. 이 식별자는 특정 날짜에 거래 상대의 VAT 상태를 확인했음을 세무 당국이 인정하는 증빙이며, 리버스 차지 청구에서 특히 중요합니다.