실시간
서비스 상태
통합하기 전에 실시간 서비스 상태와 문서화된 실패 응답을 확인하세요.
신원 및 검증
VAT 번호 검증 API
결제 또는 온보딩 시점에 고객의 VAT 번호를 확인하세요. EU 및 북아일랜드 번호는 EU VAT 등록부로, 노르웨이 번호는 노르웨이 사업자 등록부로 실시간 확인하며, 해당 국가가 공개하는 경우 등록된 상호와 주소도 제공합니다.
카테고리
신원 및 검증
엔드포인트
1
주요 기능
4
자주 묻는 질문
4
다음 회사의 사람들이 사용합니다
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
OpenAPI
API 자료
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
API 키
보호된 액세스
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
10,000
무료 한도
매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.
이 API로 만들 수 있는 것
이 페이지를 프로덕션 요약으로 사용하세요. 엔드포인트, 예제, 응답 구조, DomScan을 제품에 연결하는 워크플로 구성 요소를 제공합니다.
도메인 검사, DNS 인텔리전스, 위험 신호 또는 보강 데이터를 온보딩, 검색, 내부 도구에 포함하세요.
반복적인 수동 조회를 예약 작업, 알림, 재현 가능한 조사 단계로 대체하세요.
제공자 페이지를 스크래핑하지 않고 예측 가능한 필드, 문서화된 상태 코드, 크레딧 비용을 사용하세요.
OpenAPI, SDK, Postman 또는 MCP를 통해 에이전트, 대시보드, SOAR 플레이북, CRM에 데이터를 공급하세요.
통합 워크플로
첫 요청부터 반복 가능한 프로덕션 사용까지의 단순한 경로입니다.
한 번 인증
문서화된 헤더로 API 키를 보내고 서비스 전반에서 요청을 일관되게 유지하세요.
예제로 조회
curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.
운영 및 모니터링
상태 코드, 크레딧 비용, 응답 필드를 사용해 재시도, 로그, 알림을 구축하세요.
개발자 키트
이 페이지에서 기계 판독 문서, 요청 컬렉션, SDK 또는 에이전트 도구로 바로 이동하세요.
매개변수 및 응답 맵
엔드포인트를 클라이언트에 연결하기 전에 입력, 출력 필드, 상태 코드를 확인하세요.
매개변수
vatcountryrequester
예제 응답
vat_numbercountry_codestatusvalidreasonformat_validchecksumregistered_nameregistered_addressname_discloseddetailsdetails.vat_registered
HTTP 상태 코드
200400401402429
엔드포인트
GET
/v1/vat/validate
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
실시간
서비스 상태
통합하기 전에 실시간 서비스 상태와 문서화된 실패 응답을 확인하세요.
OpenAPI
API 자료
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
API 키
보호된 액세스
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
10,000
무료 한도
매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.
주요 기능
실시간 등록부 확인
유효성은 캐시된 목록이나 형식 확인만이 아니라, 요청하는 시점의 공식 등록부에서 가져옵니다.
확인 증빙
본인의 EU VAT 번호를 요청자로 보내면 조회 번호를 받을 수 있으며, 이를 역과세 청구서 발행의 증빙으로 보관할 수 있습니다.
형식과 검증 숫자 우선 확인
형식이 잘못된 번호는 등록부 호출 없이 거부되며, 지원하는 모든 국가에 대해 검증 숫자가 보고됩니다.
알 수 없음이지, 유효하지 않음이 아닙니다
국가 등록부가 중단되었거나 혼잡할 때는 결과가 사유와 함께 알 수 없음으로 표시되며 요청에 요금이 청구되지 않습니다.
예제 요청
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/vat/validate?vat=NO923609016MVA"예제 응답
{
"vat_number": "NO923609016MVA",
"country_code": "NO",
"status": "valid",
"valid": true,
"reason": "active_vat_registration",
"format_valid": true,
"checksum": "valid",
"registered_name": "EQUINOR ASA",
"registered_address": "Forusbeen 50, 4035 STAVANGER, Norge",
"name_disclosed": true,
"details": { "vat_registered": true, "vat_registered_since": "1989-07-01", "bankrupt": false }
}자주 묻는 질문
어떤 국가를 지원하나요?
EU 27개국과 북아일랜드, 노르웨이는 실시간으로 확인합니다. 영국, 스위스, 호주 번호는 무료 공개 확인을 제공하는 등록부가 없으므로 형식과 검증 숫자만 확인합니다.
사업자 이름이 없는 이유는 무엇인가요?
독일과 스페인 같은 일부 국가는 EU 등록부를 통해 이름과 주소를 공개하지 않습니다. 이 경우 결과에서 name_disclosed가 false로 설정됩니다.
알 수 없음은 무슨 뜻인가요?
등록부가 응답을 줄 수 없었다는 뜻입니다. 이용할 수 없었거나, 혼잡했거나, 너무 느렸습니다. 나중에 다시 시도하세요. 알 수 없음 결과는 환불됩니다.
크레딧은 얼마나 사용되나요?
확인 1회당 1크레딧입니다. 알 수 없음으로 끝난 확인에는 요금이 청구되지 않습니다.
관련 도구 및 리소스
HTTP 상태 코드
다음은 처리해야 할 HTTP 상태 코드입니다. 성공 응답, 인증 문제, 크레딧, 속도 제한, 누락된 데이터, 업스트림 장애를 구분하는 데 사용하세요.
성공
200
요청 성공
잘못된 요청
400
잘못된 매개변수
인증되지 않음
401
API 키 또는 세션이 없거나 유효하지 않습니다.
결제 필요
402
이 요청을 실행할 크레딧이 부족합니다.
요청 과다
429
속도 제한 초과
VAT 번호 검증하기