Japan インボイス登録番号 Validation API
Validate Japan インボイス登録番号 numbers via REST API. Backed by Format validation (NTA invoice register lookup coming) — returns registration status, company name, and address in a single call.
Quick start
CURL
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://www.taxid.dev/api/v1/validate/JP/T1234567890123
Single validation
Validate one Japan インボイス登録番号 number. Returns full company details for valid numbers.
const res = await fetch(
'https://www.taxid.dev/api/v1/validate/JP/T1234567890123',
{ headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const data = await res.json();
/*
{
"valid": true,
"status": "active",
"company_name": "Example GmbH",
"address": "Musterstraße 1, Japan",
"country_code": "JP",
"vat_number": "T1234567890123",
"cached": false,
"request_id": "req_01abc..."
}
*/Response format
{
"valid": true,
"status": "active",
"company_name": "Example Japan Ltd",
"address": "Musterstraße 1, Japan",
"country_code": "JP",
"vat_number": "T1234567890123",
"cached": false,
"request_id": "req_01abc..."
}| Field | Type | Description |
|---|---|---|
| valid | boolean | true if the number is registered and active |
| status | string | "active", "inactive", "not_found", or "invalid_format" |
| company_name | string | null | Registered company name (where available from authority) |
| address | string | null | Registered address (where available from authority) |
| country_code | string | ISO 2-letter code — always "JP" for this endpoint |
| vat_number | string | The VAT number as sent in the request |
| cached | boolean | true if result served from cache (valid: 24h, invalid: 1h) |
| request_id | string | Unique request ID for support and audit logs |
Batch validation
Validate up to 25 numbers in a single POST request. Numbers are processed in parallel — ideal for onboarding flows and nightly reconciliation.
curl -s -X POST https://www.taxid.dev/api/v1/validate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"numbers": [
{ "country": "JP", "vat": "T1234567890123" },
{ "country": "JP", "vat": "T1234567890129" }
]
}'[
{
"vat": "T1234567890123",
"valid": true,
"status": "active",
"company_name": "Example Ltd",
"country_code": "JP",
"cached": false
},
{
"vat": "T1234567890129",
"valid": false,
"status": "not_found",
"country_code": "JP",
"cached": false
}
]Error codes
| HTTP status | Meaning | Action |
|---|---|---|
| 400 | Bad request — malformed VAT format | Check the VAT format against the pattern below |
| 401 | Missing or invalid API key | Pass a valid Bearer token in the Authorization header |
| 404 | Country not supported | Check /vat-api for the full list of supported countries |
| 422 | Validation failed — invalid format | The number does not match the expected format |
| 429 | Rate limit exceeded | Back off and retry after the Retry-After header value |
| 503 | Upstream authority unavailable | VIES/authority is temporarily down — retry with exponential backoff |
Japan インボイス登録番号 format reference
| Property | Value |
|---|---|
| Country code (ISO) | JP |
| Local name | インボイス登録番号 (Invoice Registration Number / Qualified Invoice Issuer Number) |
| Format | T + 13 digits (a company's corporate number, or a number assigned to a sole proprietor) |
| Regex | ^T[0-9]{13}$ |
| Example | T1234567890123 |
| Standard rate | 10% |
| Validation source | Format validation (NTA invoice register lookup coming) |
| VIES supported | No |
Japan introduced a Qualified Invoice System (インボイス制度) in October 2023. Registered businesses receive a 13-digit invoice registration number prefixed with T: a company's is its corporate number (法人番号), a sole proprietor's is a separate number. TaxID checks it against the NTA's Qualified Invoice Issuer Publication Site. The 8% reduced rate applies to food and non-alcoholic beverages. Japan's consumption tax (消費税) replaced the simpler sales tax in 1989.
Frequently asked questions
What does the TaxID API return for a Japan インボイス登録番号 validation?
For a valid Japan インボイス登録番号 number the API returns: `valid: true`, `status: "active"`, plus `company_name` and `address` where available from Format validation (NTA invoice register lookup coming). For invalid numbers it returns `valid: false` with a reason code. All fields are documented in the API reference.
How fast is the Japan インボイス登録番号 validation API?
Cached results (valid numbers are cached 24h, invalid 1h) respond in under 10ms. Uncached requests that require a live lookup via Format validation (NTA invoice register lookup coming) typically complete in 100–400ms. The `cached` field in the response tells you whether the result came from cache.
What is the Japan インボイス登録番号 number format?
Japan インボイス登録番号 numbers (インボイス登録番号 (Invoice Registration Number / Qualified Invoice Issuer Number)) follow the pattern: T + 13 digits (a company's corporate number, or a number assigned to a sole proprietor). A valid example is `T1234567890123`. The TaxID API validates the format locally before making any live request, so malformed numbers fail instantly without consuming your quota.
Can I validate multiple Japan インボイス登録番号 numbers in one request?
Yes. The batch endpoint (POST /api/v1/validate) accepts up to 25 VAT numbers in a single request, processed in parallel. This is ideal for bulk onboarding flows, nightly reconciliation jobs, or importing customer lists. Each item in the response array maps 1-to-1 with your input array.
Start validating Japan インボイス登録番号 numbers
Free plan — 100 validations/month. No credit card required.
Integrate with your stack:
More Japan resources:
Validate VAT in other countries: