Japan Business Mix API
Developer documentation
Search and resolve Japanese businesses using English or romanized input, with official National Tax Agency corporate-number and qualified-invoice verification.
One developer query. Send an English or romanized company name, romanized location, 13-digit corporate number, or T-prefixed invoice registration number. The response returns the official Japanese legal name and structured company details.
Why Business Mix API?
Japanese corporate searches require legal-form handling, Japanese addresses, and several government sources. Business Mix normalizes those differences and reports where every fact came from.
- Japanese corporate name normalization
- Prefix/suffix corporate type handling
- Nationwide address and postal-code resolution
- Parcel/residential evidence where public data exists
- Source provenance and provider-specific freshness
- English-friendly structured JSON
Quick Start
Make the first request
Send your secret in the Bearer header. Never put it in the query string, browser storage, or a repository.
curl "https://api.japanapistore.com/v1/business/resolve?q=Toyota%20Motor%20Corporation" \
-H "Authorization: Bearer ${JAPAN_API_KEY}"GET /v1/business/resolve
This is the recommended one-query endpoint. It returns a detailed response only when one business can be selected without guessing.
View query contract
{
"additionalProperties": false,
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"minLength": 1,
"maxLength": 120,
"description": "English or romanized company name, romanized location, 13-digit corporate number, or T-prefixed qualified invoice registration number. Official Japanese details are returned in the response.",
"examples": [
"Toyota Motor Corporation",
"Sony Group Corporation",
"Nintendo Co., Ltd.",
"1180301018771",
"T1180301018771"
],
"type": "string"
},
"limit": {
"minimum": 1,
"maximum": 20,
"default": 10,
"type": "integer"
},
"prefecture": {
"minLength": 2,
"maxLength": 16,
"type": "string"
}
}
}View response contract
{
"$id": "BusinessLookupResponse",
"anyOf": [
{
"$id": "BusinessSearchResponse",
"additionalProperties": false,
"type": "object",
"required": [
"request_id",
"success",
"input",
"candidates",
"match",
"warnings",
"providers"
],
"properties": {
"request_id": {
"pattern": "^req_[a-f0-9]{32}$",
"type": "string"
},
"success": {
"const": true,
"type": "boolean"
},
"input": {
"additionalProperties": false,
"type": "object",
"required": [
"query",
"normalized_query",
"detected_type",
"prefecture_filter"
],
"properties": {
"query": {
"type": "string"
},
"normalized_query": {
"type": "string"
},
"detected_type": {
"anyOf": [
{
"const": "company_name",
"type": "string"
},
{
"const": "corporate_number",
"type": "string"
},
{
"const": "address",
"type": "string"
}
]
},
"prefecture_filter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"candidates": {
"maxItems": 20,
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"corporate_number",
"official_name",
"normalized_name",
"english_name",
"entity_type",
"entity_type_label",
"entity_type_label_en",
"address",
"prefecture",
"municipality",
"corporate_type",
"corporate_type_en",
"corporate_type_position",
"match_score",
"match_type",
"search_aliases",
"source"
],
"properties": {
"corporate_number": {
"pattern": "^[0-9]{13}$",
"type": "string"
},
"official_name": {
"type": "string"
},
"normalized_name": {
"type": "string"
},
"english_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type_label_en": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"prefecture": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"municipality": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_type_en": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_type_position": {
"anyOf": [
{
"const": "prefix",
"type": "string"
},
{
"const": "suffix",
"type": "string"
},
{
"const": "none",
"type": "string"
},
{
"const": "unknown",
"type": "string"
}
]
},
"match_score": {
"minimum": 0,
"maximum": 1,
"type": "number"
},
"match_type": {
"anyOf": [
{
"const": "exact",
"type": "string"
},
{
"const": "prefix",
"type": "string"
},
{
"const": "contains",
"type": "string"
},
{
"const": "fuzzy",
"type": "string"
}
]
},
"search_aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"source": {
"type": "string"
}
}
}
},
"match": {
"additionalProperties": false,
"type": "object",
"required": [
"status",
"confidence",
"candidate_count"
],
"properties": {
"status": {
"anyOf": [
{
"const": "matched",
"type": "string"
},
{
"const": "multiple_candidates",
"type": "string"
},
{
"const": "not_found",
"type": "string"
}
]
},
"confidence": {
"anyOf": [
{
"const": "exact",
"type": "string"
},
{
"const": "high",
"type": "string"
},
{
"const": "medium",
"type": "string"
},
{
"const": "low",
"type": "string"
},
{
"const": "unresolved",
"type": "string"
}
]
},
"candidate_count": {
"minimum": 0,
"maximum": 20,
"type": "integer"
}
}
},
"warnings": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"provider",
"reason",
"message"
],
"properties": {
"provider": {
"type": "string"
},
"reason": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
},
"providers": {
"additionalProperties": false,
"type": "object",
"required": [
"nta",
"gbizinfo",
"estat",
"edinet",
"mlit_reinfolib",
"address_mix"
],
"properties": {
"nta": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"gbizinfo": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"estat": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"edinet": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"mlit_reinfolib": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"address_mix": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
}
}
}
}
},
{
"$id": "BusinessMixResponse",
"additionalProperties": false,
"type": "object",
"required": [
"request_id",
"success",
"company",
"nta",
"invoice",
"address",
"business",
"corporate_group",
"surroundings",
"market_demographics",
"property_location",
"government_public",
"trust_signals",
"search_aliases",
"provenance",
"query",
"match",
"corporate",
"location",
"industry",
"registrations",
"financial",
"real_estate",
"sources",
"warnings",
"data_freshness",
"providers"
],
"properties": {
"request_id": {
"pattern": "^req_[a-f0-9]{32}$",
"type": "string"
},
"success": {
"const": true,
"type": "boolean"
},
"company": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"corporate_number",
"official_name",
"normalized_name",
"english_name",
"entity_type",
"entity_type_code",
"entity_type_label",
"entity_type_label_en",
"status",
"raw_status",
"furigana"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"corporate_number": {
"pattern": "^[0-9]{13}$",
"type": "string"
},
"official_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"normalized_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"english_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type_label_en": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"raw_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"furigana": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"nta": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"verified",
"status",
"corporate_number",
"official_name",
"address",
"assignment_date",
"update_date",
"change_date",
"close_date",
"checked_at",
"source"
],
"properties": {
"available": {
"type": "boolean"
},
"verified": {
"type": "boolean"
},
"status": {
"anyOf": [
{
"const": "verified",
"type": "string"
},
{
"const": "official_directory",
"type": "string"
},
{
"const": "not_found",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "temporarily_unavailable",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"corporate_number": {
"pattern": "^[0-9]{13}$",
"type": "string"
},
"official_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"assignment_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"update_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"change_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"close_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"invoice": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"registered",
"valid",
"status",
"registration_number",
"registration_date",
"cancellation_date",
"expiration_date",
"update_date",
"name",
"address",
"checked_at",
"source"
],
"properties": {
"available": {
"type": "boolean"
},
"registered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"valid": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"const": "registered",
"type": "string"
},
{
"const": "cancelled",
"type": "string"
},
{
"const": "expired",
"type": "string"
},
{
"const": "not_registered",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "temporarily_unavailable",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"registration_number": {
"pattern": "^T[0-9]{13}$",
"type": "string"
},
"registration_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"cancellation_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"expiration_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"update_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"address": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"input",
"normalized",
"postal_code",
"prefecture",
"city",
"municipality",
"town",
"machiaza",
"lot",
"sub_number",
"building",
"room",
"normalized_address",
"source_address",
"verified_address",
"verified_level",
"addressing_system",
"unresolved_components",
"latitude",
"longitude",
"address_code",
"resolution"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"input": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"normalized": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postal_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"prefecture": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"municipality": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"town": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"machiaza": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lot": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sub_number": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"building": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"room": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"normalized_address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verified_address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verified_level": {
"anyOf": [
{
"anyOf": [
{
"const": "none",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "municipality",
"type": "string"
},
{
"const": "machiaza",
"type": "string"
},
{
"const": "block",
"type": "string"
},
{
"const": "lot",
"type": "string"
},
{
"const": "building",
"type": "string"
},
{
"const": "residential_number",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"addressing_system": {
"anyOf": [
{
"anyOf": [
{
"const": "residential_address",
"type": "string"
},
{
"const": "land_lot",
"type": "string"
},
{
"const": "unknown",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"unresolved_components": {
"type": "array",
"items": {
"type": "string"
}
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"address_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"resolution": {
"additionalProperties": false,
"type": "object",
"required": [
"match_status",
"confidence",
"match_level",
"coordinate_level",
"unmatched_text"
],
"properties": {
"match_status": {
"anyOf": [
{
"anyOf": [
{
"const": "matched",
"type": "string"
},
{
"const": "partial",
"type": "string"
},
{
"const": "ambiguous",
"type": "string"
},
{
"const": "not_found",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"confidence": {
"anyOf": [
{
"anyOf": [
{
"const": "high",
"type": "string"
},
{
"const": "medium",
"type": "string"
},
{
"const": "low",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"match_level": {
"anyOf": [
{
"anyOf": [
{
"const": "none",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "municipality",
"type": "string"
},
{
"const": "machiaza",
"type": "string"
},
{
"const": "machiaza_detail",
"type": "string"
},
{
"const": "block",
"type": "string"
},
{
"const": "residence",
"type": "string"
},
{
"const": "residential_number",
"type": "string"
},
{
"const": "parcel",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"coordinate_level": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"const": "none",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "municipality",
"type": "string"
},
{
"const": "machiaza",
"type": "string"
},
{
"const": "machiaza_detail",
"type": "string"
},
{
"const": "block",
"type": "string"
},
{
"const": "residence",
"type": "string"
},
{
"const": "residential_number",
"type": "string"
},
{
"const": "parcel",
"type": "string"
}
]
},
{
"const": "unavailable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"unmatched_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
}
}
},
"business": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"name",
"normalized_name",
"name_ja",
"official_name_en",
"romanized_name",
"romanized_name_status",
"corporate_type",
"corporate_type_en",
"corporate_type_position",
"business_status",
"industry",
"business_summary",
"employee_count",
"capital_stock",
"company_url"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"normalized_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name_ja": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"official_name_en": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"romanized_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"romanized_name_status": {
"anyOf": [
{
"const": "official",
"type": "string"
},
{
"const": "generated",
"type": "string"
},
{
"const": "unavailable",
"type": "string"
}
]
},
"corporate_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_type_en": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_type_position": {
"anyOf": [
{
"const": "prefix",
"type": "string"
},
{
"const": "suffix",
"type": "string"
},
{
"const": "none",
"type": "string"
},
{
"const": "unknown",
"type": "string"
}
]
},
"business_status": {
"anyOf": [
{
"const": "active",
"type": "string"
},
{
"const": "closed",
"type": "string"
},
{
"const": "unknown",
"type": "string"
}
]
},
"industry": {
"type": "array",
"items": {
"type": "string"
}
},
"business_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"employee_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"capital_stock": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"company_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"corporate_group": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"group_name",
"as_of",
"coverage_note",
"disclosed_group_company_count",
"consolidated_subsidiary_count",
"equity_method_associate_joint_venture_count",
"members",
"sources"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"group_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"coverage_note": {
"type": "string"
},
"disclosed_group_company_count": {
"minimum": 0,
"type": "integer"
},
"consolidated_subsidiary_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"equity_method_associate_joint_venture_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"members": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"name",
"english_name",
"relationship_type",
"established",
"business_summary",
"company_url"
],
"properties": {
"name": {
"type": "string"
},
"english_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"relationship_type": {
"anyOf": [
{
"const": "official_group_company",
"type": "string"
},
{
"const": "parent_company",
"type": "string"
},
{
"const": "consolidated_subsidiary",
"type": "string"
},
{
"const": "equity_method_affiliate",
"type": "string"
},
{
"const": "other_related_company",
"type": "string"
}
]
},
"established": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"business_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"company_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
}
},
"sources": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"title",
"url",
"as_of",
"retrieved_at"
],
"properties": {
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"as_of": {
"type": "string"
},
"retrieved_at": {
"format": "date-time",
"type": "string"
}
}
}
}
}
},
"surroundings": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"nearest_region",
"administrative_area",
"municipality_code",
"coordinate_level",
"regional_attributes",
"stations",
"facilities"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"nearest_region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"administrative_area": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"municipality_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"coordinate_level": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"const": "none",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "municipality",
"type": "string"
},
{
"const": "machiaza",
"type": "string"
},
{
"const": "machiaza_detail",
"type": "string"
},
{
"const": "block",
"type": "string"
},
{
"const": "residence",
"type": "string"
},
{
"const": "residential_number",
"type": "string"
},
{
"const": "parcel",
"type": "string"
}
]
},
{
"const": "unavailable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"regional_attributes": {
"type": "array",
"items": {
"type": "string"
}
},
"stations": {
"type": "array",
"items": {
"type": "string"
}
},
"facilities": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"market_demographics": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"population",
"households",
"age_distribution",
"area_statistics",
"reference_year",
"geographic_level",
"stats_table_ids",
"unknown_age"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"population": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"households": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"age_distribution": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"area_statistics": {
"type": "object",
"patternProperties": {
"^(.*)$": {
"type": "number"
}
}
},
"reference_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"geographic_level": {
"anyOf": [
{
"const": "municipality",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "national",
"type": "string"
},
{
"type": "null"
}
]
},
"stats_table_ids": {
"type": "object",
"patternProperties": {
"^(.*)$": {
"type": "string"
}
}
},
"unknown_age": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
}
},
"property_location": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"land_use",
"zoning",
"location_attributes",
"prefecture",
"municipality",
"building_coverage_ratio",
"floor_area_ratio"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"land_use": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zoning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"location_attributes": {
"type": "array",
"items": {
"type": "string"
}
},
"prefecture": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"municipality": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"building_coverage_ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"floor_area_ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
}
},
"government_public": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"subsidies",
"procurements",
"certifications",
"commendations",
"patents",
"filings"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"subsidies": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"procurements": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"certifications": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"commendations": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"patents": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"filings": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
}
}
},
"trust_signals": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"corporate_information_verified",
"public_record_count",
"certification_count",
"procurement_count",
"subsidy_count",
"filing_count",
"patent_count",
"commendation_count",
"data_freshness",
"disclaimer"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"corporate_information_verified": {
"type": "boolean"
},
"public_record_count": {
"minimum": 0,
"type": "integer"
},
"certification_count": {
"minimum": 0,
"type": "integer"
},
"procurement_count": {
"minimum": 0,
"type": "integer"
},
"subsidy_count": {
"minimum": 0,
"type": "integer"
},
"filing_count": {
"minimum": 0,
"type": "integer"
},
"patent_count": {
"minimum": 0,
"type": "integer"
},
"commendation_count": {
"minimum": 0,
"type": "integer"
},
"data_freshness": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"value"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"disclaimer": {
"type": "string"
}
}
},
"search_aliases": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"values"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"values": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"provenance": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"sources"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"sources": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"source",
"dataset",
"status",
"source_type",
"provider",
"fields",
"retrieved_at",
"last_updated",
"quality",
"confidence",
"fallback_used"
],
"properties": {
"source": {
"type": "string"
},
"dataset": {
"type": "string"
},
"status": {
"type": "string"
},
"source_type": {
"anyOf": [
{
"const": "government_api",
"type": "string"
},
{
"const": "government_open_data",
"type": "string"
},
{
"const": "government_statistics",
"type": "string"
},
{
"const": "japan_api_store",
"type": "string"
},
{
"const": "official_company_disclosure",
"type": "string"
}
]
},
"provider": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "string"
}
},
"retrieved_at": {
"format": "date-time",
"type": "string"
},
"last_updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"quality": {
"anyOf": [
{
"const": "official",
"type": "string"
},
{
"const": "derived",
"type": "string"
},
{
"const": "unavailable",
"type": "string"
}
]
},
"confidence": {
"anyOf": [
{
"const": "high",
"type": "string"
},
{
"const": "medium",
"type": "string"
},
{
"const": "low",
"type": "string"
}
]
},
"fallback_used": {
"type": "boolean"
}
}
}
}
}
},
"query": {
"additionalProperties": false,
"type": "object",
"required": [
"input",
"normalized",
"detected_type"
],
"properties": {
"input": {
"type": "string"
},
"normalized": {
"type": "string"
},
"detected_type": {
"anyOf": [
{
"const": "company_name",
"type": "string"
},
{
"const": "corporate_number",
"type": "string"
},
{
"const": "address",
"type": "string"
}
]
}
}
},
"match": {
"additionalProperties": false,
"type": "object",
"required": [
"status",
"confidence"
],
"properties": {
"status": {
"anyOf": [
{
"const": "matched",
"type": "string"
},
{
"const": "partial",
"type": "string"
},
{
"const": "not_found",
"type": "string"
}
]
},
"confidence": {
"anyOf": [
{
"const": "exact",
"type": "string"
},
{
"const": "high",
"type": "string"
},
{
"const": "medium",
"type": "string"
},
{
"const": "low",
"type": "string"
},
{
"const": "unresolved",
"type": "string"
}
]
}
}
},
"corporate": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"corporate_number",
"corporate_number_status",
"registration_status"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"corporate_number": {
"anyOf": [
{
"pattern": "^[0-9]{13}$",
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_number_status": {
"anyOf": [
{
"const": "verified",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "not_found",
"type": "string"
}
]
},
"registration_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"location": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"latitude",
"longitude",
"coordinate_level",
"coordinate_source"
],
"properties": {
"available": {
"type": "boolean"
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"coordinate_level": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"const": "none",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "municipality",
"type": "string"
},
{
"const": "machiaza",
"type": "string"
},
{
"const": "machiaza_detail",
"type": "string"
},
{
"const": "block",
"type": "string"
},
{
"const": "residence",
"type": "string"
},
{
"const": "residential_number",
"type": "string"
},
{
"const": "parcel",
"type": "string"
}
]
},
{
"const": "unavailable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"coordinate_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"industry": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"classifications",
"summary"
],
"properties": {
"available": {
"type": "boolean"
},
"classifications": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"registrations": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"certifications",
"commendations",
"procurements",
"subsidies",
"patents"
],
"properties": {
"available": {
"type": "boolean"
},
"certifications": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"commendations": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"procurements": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"subsidies": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"patents": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
}
}
},
"financial": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"edinet_code",
"securities_code",
"filing_available",
"latest_filing",
"fiscal_period"
],
"properties": {
"available": {
"type": "boolean"
},
"edinet_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"securities_code": {
"type": "null"
},
"filing_available": {
"type": "boolean"
},
"latest_filing": {
"anyOf": [
{
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
},
{
"type": "null"
}
]
},
"fiscal_period": {
"additionalProperties": false,
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
}
}
},
"real_estate": {
"additionalProperties": false,
"type": "object",
"required": [
"scope",
"available",
"land_use",
"zoning",
"ownership_inferred"
],
"properties": {
"scope": {
"const": "address_area",
"type": "string"
},
"available": {
"type": "boolean"
},
"land_use": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zoning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ownership_inferred": {
"const": false,
"type": "boolean"
}
}
},
"sources": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"source",
"dataset",
"status",
"source_type",
"provider",
"fields",
"retrieved_at",
"last_updated",
"quality",
"confidence",
"fallback_used"
],
"properties": {
"source": {
"type": "string"
},
"dataset": {
"type": "string"
},
"status": {
"type": "string"
},
"source_type": {
"anyOf": [
{
"const": "government_api",
"type": "string"
},
{
"const": "government_open_data",
"type": "string"
},
{
"const": "government_statistics",
"type": "string"
},
{
"const": "japan_api_store",
"type": "string"
},
{
"const": "official_company_disclosure",
"type": "string"
}
]
},
"provider": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "string"
}
},
"retrieved_at": {
"format": "date-time",
"type": "string"
},
"last_updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"quality": {
"anyOf": [
{
"const": "official",
"type": "string"
},
{
"const": "derived",
"type": "string"
},
{
"const": "unavailable",
"type": "string"
}
]
},
"confidence": {
"anyOf": [
{
"const": "high",
"type": "string"
},
{
"const": "medium",
"type": "string"
},
{
"const": "low",
"type": "string"
}
]
},
"fallback_used": {
"type": "boolean"
}
}
}
},
"warnings": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"provider",
"reason",
"message"
],
"properties": {
"provider": {
"type": "string"
},
"reason": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
},
"data_freshness": {
"type": "object",
"patternProperties": {
"^(.*)$": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"providers": {
"additionalProperties": false,
"type": "object",
"required": [
"nta",
"gbizinfo",
"estat",
"edinet",
"mlit_reinfolib",
"address_mix"
],
"properties": {
"nta": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"gbizinfo": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"estat": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"edinet": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"mlit_reinfolib": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"address_mix": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
}
}
}
}
}
]
}GET /v1/business/search
Use the candidate-only endpoint when your interface always needs a selection step. prefecture is optional and never changes the official company name.
View search response contract
{
"$id": "BusinessSearchResponse",
"additionalProperties": false,
"type": "object",
"required": [
"request_id",
"success",
"input",
"candidates",
"match",
"warnings",
"providers"
],
"properties": {
"request_id": {
"pattern": "^req_[a-f0-9]{32}$",
"type": "string"
},
"success": {
"const": true,
"type": "boolean"
},
"input": {
"additionalProperties": false,
"type": "object",
"required": [
"query",
"normalized_query",
"detected_type",
"prefecture_filter"
],
"properties": {
"query": {
"type": "string"
},
"normalized_query": {
"type": "string"
},
"detected_type": {
"anyOf": [
{
"const": "company_name",
"type": "string"
},
{
"const": "corporate_number",
"type": "string"
},
{
"const": "address",
"type": "string"
}
]
},
"prefecture_filter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"candidates": {
"maxItems": 20,
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"corporate_number",
"official_name",
"normalized_name",
"english_name",
"entity_type",
"entity_type_label",
"entity_type_label_en",
"address",
"prefecture",
"municipality",
"corporate_type",
"corporate_type_en",
"corporate_type_position",
"match_score",
"match_type",
"search_aliases",
"source"
],
"properties": {
"corporate_number": {
"pattern": "^[0-9]{13}$",
"type": "string"
},
"official_name": {
"type": "string"
},
"normalized_name": {
"type": "string"
},
"english_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type_label_en": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"prefecture": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"municipality": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_type_en": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_type_position": {
"anyOf": [
{
"const": "prefix",
"type": "string"
},
{
"const": "suffix",
"type": "string"
},
{
"const": "none",
"type": "string"
},
{
"const": "unknown",
"type": "string"
}
]
},
"match_score": {
"minimum": 0,
"maximum": 1,
"type": "number"
},
"match_type": {
"anyOf": [
{
"const": "exact",
"type": "string"
},
{
"const": "prefix",
"type": "string"
},
{
"const": "contains",
"type": "string"
},
{
"const": "fuzzy",
"type": "string"
}
]
},
"search_aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"source": {
"type": "string"
}
}
}
},
"match": {
"additionalProperties": false,
"type": "object",
"required": [
"status",
"confidence",
"candidate_count"
],
"properties": {
"status": {
"anyOf": [
{
"const": "matched",
"type": "string"
},
{
"const": "multiple_candidates",
"type": "string"
},
{
"const": "not_found",
"type": "string"
}
]
},
"confidence": {
"anyOf": [
{
"const": "exact",
"type": "string"
},
{
"const": "high",
"type": "string"
},
{
"const": "medium",
"type": "string"
},
{
"const": "low",
"type": "string"
},
{
"const": "unresolved",
"type": "string"
}
]
},
"candidate_count": {
"minimum": 0,
"maximum": 20,
"type": "integer"
}
}
},
"warnings": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"provider",
"reason",
"message"
],
"properties": {
"provider": {
"type": "string"
},
"reason": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
},
"providers": {
"additionalProperties": false,
"type": "object",
"required": [
"nta",
"gbizinfo",
"estat",
"edinet",
"mlit_reinfolib",
"address_mix"
],
"properties": {
"nta": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"gbizinfo": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"estat": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"edinet": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"mlit_reinfolib": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"address_mix": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
}
}
}
}
}Unified response
The legacy fields remain unchanged. Additive nta and invoice objects expose official corporate verification and qualified invoice issuer status alongside business, address, financial, sources, warnings, and data_freshness.
View detailed response contract
{
"$id": "BusinessMixResponse",
"additionalProperties": false,
"type": "object",
"required": [
"request_id",
"success",
"company",
"nta",
"invoice",
"address",
"business",
"corporate_group",
"surroundings",
"market_demographics",
"property_location",
"government_public",
"trust_signals",
"search_aliases",
"provenance",
"query",
"match",
"corporate",
"location",
"industry",
"registrations",
"financial",
"real_estate",
"sources",
"warnings",
"data_freshness",
"providers"
],
"properties": {
"request_id": {
"pattern": "^req_[a-f0-9]{32}$",
"type": "string"
},
"success": {
"const": true,
"type": "boolean"
},
"company": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"corporate_number",
"official_name",
"normalized_name",
"english_name",
"entity_type",
"entity_type_code",
"entity_type_label",
"entity_type_label_en",
"status",
"raw_status",
"furigana"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"corporate_number": {
"pattern": "^[0-9]{13}$",
"type": "string"
},
"official_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"normalized_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"english_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_type_label_en": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"raw_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"furigana": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"nta": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"verified",
"status",
"corporate_number",
"official_name",
"address",
"assignment_date",
"update_date",
"change_date",
"close_date",
"checked_at",
"source"
],
"properties": {
"available": {
"type": "boolean"
},
"verified": {
"type": "boolean"
},
"status": {
"anyOf": [
{
"const": "verified",
"type": "string"
},
{
"const": "official_directory",
"type": "string"
},
{
"const": "not_found",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "temporarily_unavailable",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"corporate_number": {
"pattern": "^[0-9]{13}$",
"type": "string"
},
"official_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"assignment_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"update_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"change_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"close_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"invoice": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"registered",
"valid",
"status",
"registration_number",
"registration_date",
"cancellation_date",
"expiration_date",
"update_date",
"name",
"address",
"checked_at",
"source"
],
"properties": {
"available": {
"type": "boolean"
},
"registered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"valid": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"const": "registered",
"type": "string"
},
{
"const": "cancelled",
"type": "string"
},
{
"const": "expired",
"type": "string"
},
{
"const": "not_registered",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "temporarily_unavailable",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"registration_number": {
"pattern": "^T[0-9]{13}$",
"type": "string"
},
"registration_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"cancellation_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"expiration_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"update_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"address": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"input",
"normalized",
"postal_code",
"prefecture",
"city",
"municipality",
"town",
"machiaza",
"lot",
"sub_number",
"building",
"room",
"normalized_address",
"source_address",
"verified_address",
"verified_level",
"addressing_system",
"unresolved_components",
"latitude",
"longitude",
"address_code",
"resolution"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"input": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"normalized": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postal_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"prefecture": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"municipality": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"town": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"machiaza": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lot": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sub_number": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"building": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"room": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"normalized_address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verified_address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"verified_level": {
"anyOf": [
{
"anyOf": [
{
"const": "none",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "municipality",
"type": "string"
},
{
"const": "machiaza",
"type": "string"
},
{
"const": "block",
"type": "string"
},
{
"const": "lot",
"type": "string"
},
{
"const": "building",
"type": "string"
},
{
"const": "residential_number",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"addressing_system": {
"anyOf": [
{
"anyOf": [
{
"const": "residential_address",
"type": "string"
},
{
"const": "land_lot",
"type": "string"
},
{
"const": "unknown",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"unresolved_components": {
"type": "array",
"items": {
"type": "string"
}
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"address_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"resolution": {
"additionalProperties": false,
"type": "object",
"required": [
"match_status",
"confidence",
"match_level",
"coordinate_level",
"unmatched_text"
],
"properties": {
"match_status": {
"anyOf": [
{
"anyOf": [
{
"const": "matched",
"type": "string"
},
{
"const": "partial",
"type": "string"
},
{
"const": "ambiguous",
"type": "string"
},
{
"const": "not_found",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"confidence": {
"anyOf": [
{
"anyOf": [
{
"const": "high",
"type": "string"
},
{
"const": "medium",
"type": "string"
},
{
"const": "low",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"match_level": {
"anyOf": [
{
"anyOf": [
{
"const": "none",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "municipality",
"type": "string"
},
{
"const": "machiaza",
"type": "string"
},
{
"const": "machiaza_detail",
"type": "string"
},
{
"const": "block",
"type": "string"
},
{
"const": "residence",
"type": "string"
},
{
"const": "residential_number",
"type": "string"
},
{
"const": "parcel",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"coordinate_level": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"const": "none",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "municipality",
"type": "string"
},
{
"const": "machiaza",
"type": "string"
},
{
"const": "machiaza_detail",
"type": "string"
},
{
"const": "block",
"type": "string"
},
{
"const": "residence",
"type": "string"
},
{
"const": "residential_number",
"type": "string"
},
{
"const": "parcel",
"type": "string"
}
]
},
{
"const": "unavailable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"unmatched_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
}
}
},
"business": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"name",
"normalized_name",
"name_ja",
"official_name_en",
"romanized_name",
"romanized_name_status",
"corporate_type",
"corporate_type_en",
"corporate_type_position",
"business_status",
"industry",
"business_summary",
"employee_count",
"capital_stock",
"company_url"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"normalized_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name_ja": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"official_name_en": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"romanized_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"romanized_name_status": {
"anyOf": [
{
"const": "official",
"type": "string"
},
{
"const": "generated",
"type": "string"
},
{
"const": "unavailable",
"type": "string"
}
]
},
"corporate_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_type_en": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_type_position": {
"anyOf": [
{
"const": "prefix",
"type": "string"
},
{
"const": "suffix",
"type": "string"
},
{
"const": "none",
"type": "string"
},
{
"const": "unknown",
"type": "string"
}
]
},
"business_status": {
"anyOf": [
{
"const": "active",
"type": "string"
},
{
"const": "closed",
"type": "string"
},
{
"const": "unknown",
"type": "string"
}
]
},
"industry": {
"type": "array",
"items": {
"type": "string"
}
},
"business_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"employee_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"capital_stock": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"company_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"corporate_group": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"group_name",
"as_of",
"coverage_note",
"disclosed_group_company_count",
"consolidated_subsidiary_count",
"equity_method_associate_joint_venture_count",
"members",
"sources"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"group_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"coverage_note": {
"type": "string"
},
"disclosed_group_company_count": {
"minimum": 0,
"type": "integer"
},
"consolidated_subsidiary_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"equity_method_associate_joint_venture_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"members": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"name",
"english_name",
"relationship_type",
"established",
"business_summary",
"company_url"
],
"properties": {
"name": {
"type": "string"
},
"english_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"relationship_type": {
"anyOf": [
{
"const": "official_group_company",
"type": "string"
},
{
"const": "parent_company",
"type": "string"
},
{
"const": "consolidated_subsidiary",
"type": "string"
},
{
"const": "equity_method_affiliate",
"type": "string"
},
{
"const": "other_related_company",
"type": "string"
}
]
},
"established": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"business_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"company_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
}
},
"sources": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"title",
"url",
"as_of",
"retrieved_at"
],
"properties": {
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"as_of": {
"type": "string"
},
"retrieved_at": {
"format": "date-time",
"type": "string"
}
}
}
}
}
},
"surroundings": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"nearest_region",
"administrative_area",
"municipality_code",
"coordinate_level",
"regional_attributes",
"stations",
"facilities"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"nearest_region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"administrative_area": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"municipality_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"coordinate_level": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"const": "none",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "municipality",
"type": "string"
},
{
"const": "machiaza",
"type": "string"
},
{
"const": "machiaza_detail",
"type": "string"
},
{
"const": "block",
"type": "string"
},
{
"const": "residence",
"type": "string"
},
{
"const": "residential_number",
"type": "string"
},
{
"const": "parcel",
"type": "string"
}
]
},
{
"const": "unavailable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"regional_attributes": {
"type": "array",
"items": {
"type": "string"
}
},
"stations": {
"type": "array",
"items": {
"type": "string"
}
},
"facilities": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"market_demographics": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"population",
"households",
"age_distribution",
"area_statistics",
"reference_year",
"geographic_level",
"stats_table_ids",
"unknown_age"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"population": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"households": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"age_distribution": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"area_statistics": {
"type": "object",
"patternProperties": {
"^(.*)$": {
"type": "number"
}
}
},
"reference_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"geographic_level": {
"anyOf": [
{
"const": "municipality",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "national",
"type": "string"
},
{
"type": "null"
}
]
},
"stats_table_ids": {
"type": "object",
"patternProperties": {
"^(.*)$": {
"type": "string"
}
}
},
"unknown_age": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
}
},
"property_location": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"land_use",
"zoning",
"location_attributes",
"prefecture",
"municipality",
"building_coverage_ratio",
"floor_area_ratio"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"land_use": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zoning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"location_attributes": {
"type": "array",
"items": {
"type": "string"
}
},
"prefecture": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"municipality": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"building_coverage_ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"floor_area_ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
}
},
"government_public": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"subsidies",
"procurements",
"certifications",
"commendations",
"patents",
"filings"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"subsidies": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"procurements": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"certifications": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"commendations": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"patents": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"filings": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
}
}
},
"trust_signals": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"corporate_information_verified",
"public_record_count",
"certification_count",
"procurement_count",
"subsidy_count",
"filing_count",
"patent_count",
"commendation_count",
"data_freshness",
"disclaimer"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"corporate_information_verified": {
"type": "boolean"
},
"public_record_count": {
"minimum": 0,
"type": "integer"
},
"certification_count": {
"minimum": 0,
"type": "integer"
},
"procurement_count": {
"minimum": 0,
"type": "integer"
},
"subsidy_count": {
"minimum": 0,
"type": "integer"
},
"filing_count": {
"minimum": 0,
"type": "integer"
},
"patent_count": {
"minimum": 0,
"type": "integer"
},
"commendation_count": {
"minimum": 0,
"type": "integer"
},
"data_freshness": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"value"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"disclaimer": {
"type": "string"
}
}
},
"search_aliases": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"values"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"values": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"provenance": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"sources"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"sources": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"source",
"dataset",
"status",
"source_type",
"provider",
"fields",
"retrieved_at",
"last_updated",
"quality",
"confidence",
"fallback_used"
],
"properties": {
"source": {
"type": "string"
},
"dataset": {
"type": "string"
},
"status": {
"type": "string"
},
"source_type": {
"anyOf": [
{
"const": "government_api",
"type": "string"
},
{
"const": "government_open_data",
"type": "string"
},
{
"const": "government_statistics",
"type": "string"
},
{
"const": "japan_api_store",
"type": "string"
},
{
"const": "official_company_disclosure",
"type": "string"
}
]
},
"provider": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "string"
}
},
"retrieved_at": {
"format": "date-time",
"type": "string"
},
"last_updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"quality": {
"anyOf": [
{
"const": "official",
"type": "string"
},
{
"const": "derived",
"type": "string"
},
{
"const": "unavailable",
"type": "string"
}
]
},
"confidence": {
"anyOf": [
{
"const": "high",
"type": "string"
},
{
"const": "medium",
"type": "string"
},
{
"const": "low",
"type": "string"
}
]
},
"fallback_used": {
"type": "boolean"
}
}
}
}
}
},
"query": {
"additionalProperties": false,
"type": "object",
"required": [
"input",
"normalized",
"detected_type"
],
"properties": {
"input": {
"type": "string"
},
"normalized": {
"type": "string"
},
"detected_type": {
"anyOf": [
{
"const": "company_name",
"type": "string"
},
{
"const": "corporate_number",
"type": "string"
},
{
"const": "address",
"type": "string"
}
]
}
}
},
"match": {
"additionalProperties": false,
"type": "object",
"required": [
"status",
"confidence"
],
"properties": {
"status": {
"anyOf": [
{
"const": "matched",
"type": "string"
},
{
"const": "partial",
"type": "string"
},
{
"const": "not_found",
"type": "string"
}
]
},
"confidence": {
"anyOf": [
{
"const": "exact",
"type": "string"
},
{
"const": "high",
"type": "string"
},
{
"const": "medium",
"type": "string"
},
{
"const": "low",
"type": "string"
},
{
"const": "unresolved",
"type": "string"
}
]
}
}
},
"corporate": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"reason",
"corporate_number",
"corporate_number_status",
"registration_status"
],
"properties": {
"available": {
"type": "boolean"
},
"reason": {
"anyOf": [
{
"anyOf": [
{
"const": "data_not_found",
"type": "string"
},
{
"const": "provider_not_connected",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "provider_error",
"type": "string"
},
{
"const": "not_applicable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"corporate_number": {
"anyOf": [
{
"pattern": "^[0-9]{13}$",
"type": "string"
},
{
"type": "null"
}
]
},
"corporate_number_status": {
"anyOf": [
{
"const": "verified",
"type": "string"
},
{
"const": "provider_pending",
"type": "string"
},
{
"const": "not_found",
"type": "string"
}
]
},
"registration_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"location": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"latitude",
"longitude",
"coordinate_level",
"coordinate_source"
],
"properties": {
"available": {
"type": "boolean"
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"coordinate_level": {
"anyOf": [
{
"anyOf": [
{
"anyOf": [
{
"const": "none",
"type": "string"
},
{
"const": "prefecture",
"type": "string"
},
{
"const": "municipality",
"type": "string"
},
{
"const": "machiaza",
"type": "string"
},
{
"const": "machiaza_detail",
"type": "string"
},
{
"const": "block",
"type": "string"
},
{
"const": "residence",
"type": "string"
},
{
"const": "residential_number",
"type": "string"
},
{
"const": "parcel",
"type": "string"
}
]
},
{
"const": "unavailable",
"type": "string"
}
]
},
{
"type": "null"
}
]
},
"coordinate_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"industry": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"classifications",
"summary"
],
"properties": {
"available": {
"type": "boolean"
},
"classifications": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"registrations": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"certifications",
"commendations",
"procurements",
"subsidies",
"patents"
],
"properties": {
"available": {
"type": "boolean"
},
"certifications": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"commendations": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"procurements": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"subsidies": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
},
"patents": {
"type": "array",
"items": {
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
}
}
}
},
"financial": {
"additionalProperties": false,
"type": "object",
"required": [
"available",
"edinet_code",
"securities_code",
"filing_available",
"latest_filing",
"fiscal_period"
],
"properties": {
"available": {
"type": "boolean"
},
"edinet_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"securities_code": {
"type": "null"
},
"filing_available": {
"type": "boolean"
},
"latest_filing": {
"anyOf": [
{
"type": "object",
"patternProperties": {
"^(.*)$": {}
}
},
{
"type": "null"
}
]
},
"fiscal_period": {
"additionalProperties": false,
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
}
}
},
"real_estate": {
"additionalProperties": false,
"type": "object",
"required": [
"scope",
"available",
"land_use",
"zoning",
"ownership_inferred"
],
"properties": {
"scope": {
"const": "address_area",
"type": "string"
},
"available": {
"type": "boolean"
},
"land_use": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zoning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ownership_inferred": {
"const": false,
"type": "boolean"
}
}
},
"sources": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"source",
"dataset",
"status",
"source_type",
"provider",
"fields",
"retrieved_at",
"last_updated",
"quality",
"confidence",
"fallback_used"
],
"properties": {
"source": {
"type": "string"
},
"dataset": {
"type": "string"
},
"status": {
"type": "string"
},
"source_type": {
"anyOf": [
{
"const": "government_api",
"type": "string"
},
{
"const": "government_open_data",
"type": "string"
},
{
"const": "government_statistics",
"type": "string"
},
{
"const": "japan_api_store",
"type": "string"
},
{
"const": "official_company_disclosure",
"type": "string"
}
]
},
"provider": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "string"
}
},
"retrieved_at": {
"format": "date-time",
"type": "string"
},
"last_updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"quality": {
"anyOf": [
{
"const": "official",
"type": "string"
},
{
"const": "derived",
"type": "string"
},
{
"const": "unavailable",
"type": "string"
}
]
},
"confidence": {
"anyOf": [
{
"const": "high",
"type": "string"
},
{
"const": "medium",
"type": "string"
},
{
"const": "low",
"type": "string"
}
]
},
"fallback_used": {
"type": "boolean"
}
}
}
},
"warnings": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"provider",
"reason",
"message"
],
"properties": {
"provider": {
"type": "string"
},
"reason": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
},
"data_freshness": {
"type": "object",
"patternProperties": {
"^(.*)$": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"providers": {
"additionalProperties": false,
"type": "object",
"required": [
"nta",
"gbizinfo",
"estat",
"edinet",
"mlit_reinfolib",
"address_mix"
],
"properties": {
"nta": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"gbizinfo": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"estat": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"edinet": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"mlit_reinfolib": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
},
"address_mix": {
"anyOf": [
{
"const": "pending",
"type": "string"
},
{
"const": "connected",
"type": "string"
},
{
"const": "error",
"type": "string"
},
{
"const": "degraded",
"type": "string"
},
{
"const": "timeout",
"type": "string"
},
{
"const": "disabled",
"type": "string"
}
]
}
}
}
}
}Candidates and confidence
Multiple companies are never collapsed into one guessed answer. Candidates include corporate type, prefecture, municipality, match type, and a bounded relevance score. Confidence is an evidence label, not a probability.
Sources
National Tax Agency Web-APIsOfficial corporate-number records and qualified invoice issuer status, including registration, cancellation, and expiration dates when published.
gBizINFOCorporate candidates, business facts, public programs, procurement, certifications, commendations, and patents when available.
Powered by Japan Address MixNationwide postal, address, parcel/residential evidence, building separation, and coordinate precision.
e-Stat, EDINET, and MLITArea demographics, filing metadata, and address-area planning context. No property ownership is inferred.
Official data, independent service.
JAPAN API STORE uses information retrieved through the National Tax Agency Corporate Number Web-API and Qualified Invoice Issuer Web-API. Application access does not mean NTA endorsement, and the NTA does not guarantee this service.
このサービスは、国税庁法人番号システムのWeb-API機能を利用して取得した情報をもとに作成しているが、サービスの内容は国税庁によって保証されたものではない。 このサービスは、適格請求書発行事業者公表システムWeb-API機能を利用して取得した情報をもとに作成しているが、サービスの内容は国税庁によって保証されたものではない。
Data freshness
Government sources update independently. data_freshness and sources[].last_updated keep verified update dates separate. A value is null when a source exposes only a dataset version or no reliable publication date; the API never labels the whole response “latest.”
Provider failures
One external provider timing out does not turn a valid request into HTTP 500. Available facts are returned with a provider-specific warning. Missing public data is a normal availability result.
Input examples
{
"company_name": "Toyota Motor Corporation",
"company_with_prefecture": "Toyota Motor Corporation, Aichi",
"address": "Toyota-cho, Toyota, Aichi",
"romanized_address": "Aichi Toyota",
"multiple_candidates": "Yamamoto Co., Ltd.",
"unavailable": "Nonexistent Company ZXCVBNM987654321",
"corporate_number": "1180301018771"
}No Japanese typing is required. English and romanized input is resolved to the official Japanese company record; generated search aliases are never presented as an official English corporate name.
Run the no-key live test or create a free API key for your own company queries.