APIFuseAPIFuse
문서서비스플레이그라운드상태
로그인회원가입

Service

Visit Japan Web

일본, 여행실험적
Playground에서 시험API 레퍼런스 열기

Overview

여행자의 Visit Japan Web 계정을 읽기 전용으로 조회합니다: 여권 프로필과 MFA 상태, 숙소가 포함된 등록 여행, 여행별 입국·세관 신고 내용, 면세 상륙허가 상태, 공개 일본 우편번호 주소 조회.

Status

계정 필요

100.00%30일 가동률평균 응답96ms

2026-10-132026-10-192026-10-25

Setup

Auth mode
계정 연동
Credentials
  • 이메일과 비밀번호로 가입한 Visit Japan Web 계정(www.vjw.digital.go.jp).
Sandbox
미제공

APIs

행을 선택하면 해당 API의 레퍼런스로 이동합니다.

MethodAPIPathSummary
POST/v1/visit-japan-web/accountReturns the account holder's Visit Japan Web profile: passport details, nationality, gender, occupation, home city, address in Japan, tax-exemption enrollment, and whether MFA is configured. Use when an agent needs identity context for the traveler before reading trips or declarations. Do NOT use to change profile data; the provider is read-only.
POST/v1/visit-japan-web/address-lookupResolves a seven-digit Japanese postal code to its prefecture, municipality, and town names in Japanese and English using the public Visit Japan Web address table. No connection is required. Use when filling or validating a Japanese accommodation address. Do NOT use for non-Japanese postal codes; unknown codes return found=false rather than an error.
POST/v1/visit-japan-web/tax-exemptionReads the account holder's tax-free shopping status: whether a landing-permission record exists, when it expires, and whether a face photo is registered. Use when a traveler asks if their Visit Japan Web tax-free QR is ready or still valid. Do NOT use to enroll in tax-free shopping or to render the QR code.
POST/v1/visit-japan-web/travel-declarationsReturns the immigration (ED card) and customs declarations the account holder filed for one registered trip, identified by travel_id from the travels operation. Includes purpose and length of stay, the three immigration questions, declared personal effects, and the customs questionnaire answers. Use when a traveler wants to review what was declared before arrival. Do NOT use to submit or amend declarations.
POST/v1/visit-japan-web/travelsLists every trip registered on the Visit Japan Web account, newest arrival first, plus the trips the service currently flags as upcoming. Each trip carries the arrival date, airline and flight, point of embarkation, and the accommodation address in Japan. Use when the agent needs a travel_id for declarations or wants to summarize the traveler's planned entries. Do NOT use to register or edit trips.

Related guides

  • key가 호출할 수 있는 서비스와 API의 범위를 정의합니다.

  • 멱등한 호출의 재시도 규칙과 backoff 동작을 설명합니다.

  • 예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.

계정 프로필
우편번호 주소 조회
면세 상태
여행 신고 내역
등록된 여행
Scope
재시도
개요