{"components":{"headers":{"CacheControl":{"description":"認証別残量を含むため全 /v1 レスポンスで private, no-store","schema":{"type":"string"}},"RetryAfter":{"description":"再試行までの秒数（429/503のみ）","schema":{"minimum":0,"type":"integer"}},"XQuotaLimit":{"description":"月次api_requests上限。無制限プラン（enterprise）では送出しない（ヘッダー省略=無制限。ボディmeta.quotaが正）","schema":{"minimum":0,"type":"integer"}},"XQuotaRemaining":{"description":"月次api_requests残量。無制限プラン（enterprise）では送出しない（ヘッダー省略=無制限。ボディmeta.quotaが正）","schema":{"minimum":0,"type":"integer"}},"XRateLimitLimit":{"description":"分単位レート上限（rpm）","schema":{"minimum":0,"type":"integer"}},"XRateLimitRemaining":{"description":"現在ウィンドウの残回数","schema":{"minimum":0,"type":"integer"}},"XRateLimitReset":{"description":"ウィンドウリセット時刻（epoch秒）。meta.rate_limit.reset と同一時点","schema":{"minimum":0,"type":"integer"}}},"schemas":{"Address":{"description":"町名・丁目番地・建物等の15分解とかな/ローマ字は将来の非破壊追加枠","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"city_code":{"anyOf":[{"pattern":"^\\d{5}$","type":"string"},{"type":"null"}]},"city_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"full":{"anyOf":[{"type":"string"},{"type":"null"}]},"image_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"非JIS文字住所の画像ID"},"post_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}]},"prefecture_code":{"anyOf":[{"pattern":"^\\d{2}$","type":"string"},{"type":"null"}]},"prefecture_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"street":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["prefecture","city","street","full","post_code","prefecture_code","city_code","prefecture_en","city_en","image_id"],"type":"object"},"AddressOutside":{"anyOf":[{"properties":{"image_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"value_en":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["value","value_en","image_id"],"type":"object"},{"type":"null"}]},"BatchJob":{"oneOf":[{"properties":{"error":{"type":"null"},"job_id":{"type":"string"},"progress":{"$ref":"#/components/schemas/BatchProgress"},"status":{"enum":["queued","processing"],"type":"string"},"summary":{"type":"null"}},"required":["job_id","status","progress","summary","error"],"type":"object"},{"properties":{"error":{"type":"null"},"job_id":{"type":"string"},"progress":{"$ref":"#/components/schemas/BatchProgress"},"status":{"const":"completed","type":"string"},"summary":{"description":"resultsはdownloadで取得","properties":{"confident":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"review":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"unmatched":{"maximum":9007199254740991,"minimum":0,"type":"integer"}},"required":["confident","review","unmatched"],"type":"object"}},"required":["job_id","status","progress","summary","error"],"type":"object"},{"properties":{"error":{"properties":{"code":{"description":"既知値は実装Issueで確定（open・追加は非破壊）","type":"string"},"message":{"type":"string"},"retry_after":{"anyOf":[{"maximum":9007199254740991,"minimum":0,"type":"integer"},{"type":"null"}]},"retryable":{"description":"trueなら同一入力の新規ジョブ再投入で回復可能","type":"boolean"}},"required":["code","message","retryable","retry_after"],"type":"object"},"job_id":{"type":"string"},"progress":{"$ref":"#/components/schemas/BatchProgress"},"status":{"const":"failed","type":"string"},"summary":{"type":"null"}},"required":["job_id","status","progress","summary","error"],"type":"object"}]},"BatchJobQueuedAck":{"properties":{"job_id":{"type":"string"},"status":{"const":"queued","type":"string"}},"required":["job_id","status"],"type":"object"},"BatchProgress":{"properties":{"done":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"total":{"maximum":9007199254740991,"minimum":0,"type":"integer"}},"required":["done","total"],"type":"object"},"BatchResultRow":{"properties":{"candidate_count":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"candidates":{"items":{"properties":{"corporate_number":{"pattern":"^\\d{13}$","type":"string"},"name":{"type":"string"},"name_kana":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"maximum":1,"minimum":0,"type":"number"}},"required":["corporate_number","name","name_kana","score"],"type":"object"},"type":"array"},"confidence":{"enum":["confident","review","unmatched"],"type":"string"},"input_name":{"type":"string"},"matched_corporate_number":{"anyOf":[{"pattern":"^\\d{13}$","type":"string"},{"type":"null"}]},"object":{"const":"batch_result_row","type":"string"},"prefecture_code":{"anyOf":[{"pattern":"^\\d{2}$","type":"string"},{"type":"null"}]},"row_index":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"score":{"maximum":1,"minimum":0,"type":"number"}},"required":["object","row_index","input_name","prefecture_code","confidence","score","candidate_count","matched_corporate_number","candidates"],"type":"object"},"Closure":{"anyOf":[{"properties":{"cause":{"anyOf":[{"type":"string"},{"type":"null"}]},"date":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]},"successor_corporate_number":{"anyOf":[{"pattern":"^\\d{13}$","type":"string"},{"type":"null"}]}},"required":["date","cause","successor_corporate_number"],"type":"object"},{"type":"null"}],"description":"active=false時のみnon-null"},"Company":{"properties":{"active":{"type":"boolean"},"address":{"$ref":"#/components/schemas/Address"},"address_outside":{"$ref":"#/components/schemas/AddressOutside"},"assignment_date":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]},"closure":{"$ref":"#/components/schemas/Closure"},"corporate_number":{"pattern":"^\\d{13}$","type":"string"},"invoice":{"anyOf":[{"$ref":"#/components/schemas/InvoiceBlock"},{"type":"null"}],"description":"インボイス登録レコードなし時null"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"name_image_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"name_kana":{"anyOf":[{"type":"string"},{"type":"null"}]},"revision":{"$ref":"#/components/schemas/Revision"},"search_excluded":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"NTA hihyoji由来。未取込時は不明としてnull"},"updated_at":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]}},"required":["corporate_number","name","name_kana","name_en","name_image_id","kind","kind_code","address","address_outside","active","closure","assignment_date","updated_at","search_excluded","revision","invoice"],"type":"object"},"CompanySummary":{"properties":{"city_code":{"anyOf":[{"pattern":"^\\d{5}$","type":"string"},{"type":"null"}]},"corporate_number":{"pattern":"^\\d{13}$","type":"string"},"name":{"type":"string"},"name_kana":{"anyOf":[{"type":"string"},{"type":"null"}]},"object":{"const":"company_summary","type":"string"},"prefecture_code":{"anyOf":[{"pattern":"^\\d{2}$","type":"string"},{"type":"null"}]},"score":{"description":"検索順位付けに使う相対スコア（0〜1）。正解確率・信頼度ではなく、mode=partial では接頭辞一致などで複数候補が同値になりうる。","maximum":1,"minimum":0,"type":"number"}},"required":["object","corporate_number","name","name_kana","prefecture_code","city_code","score"],"type":"object"},"Envelope":{"properties":{"data":{"description":"本体。各operationのschemaで具体型に上書きされる"},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/Meta"},"object":{"type":"string"},"schema_version":{"description":"現行構造の最終変更年月（YYYY-MM・情報提供専用）","pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}},"required":["object","schema_version","data","links","meta"],"type":"object"},"InvoiceBlock":{"properties":{"cancel_date":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"国内/国外区分（NTA country由来。国籍ではない）。既知値: domestic / foreign。実測で第3区分コードが存在するためopen（値マッピングは実装Issueで確定）"},"expire_date":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]},"found":{"type":"boolean"},"registered":{"type":"boolean"},"registration_date":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]},"registration_number":{"anyOf":[{"pattern":"^T\\d{13}$","type":"string"},{"type":"null"}]},"valid":{"type":"boolean"}},"required":["found","registration_number","registered","registration_date","cancel_date","expire_date","valid","country"],"type":"object"},"InvoiceIssuer":{"description":"法人/個人完全同形。個人は提供不能値がnull。トップレベルcountryとinvoice.countryは同一値（invoiceブロックは登録レコード同梱の写し）","properties":{"active":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"address":{"anyOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}],"description":"本店または主たる事務所の所在地（個人はNTA公表分のみ）"},"address_inside":{"anyOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}],"description":"国外事業者の国内事務所所在地（NTA address_inside由来）"},"address_outside":{"$ref":"#/components/schemas/AddressOutside"},"address_request":{"anyOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}],"description":"申請書記載の事務所所在地（NTA address_request由来）"},"assignment_date":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]},"closure":{"$ref":"#/components/schemas/Closure"},"corporate_number":{"anyOf":[{"pattern":"^\\d{13}$","type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"国内/国外区分（NTA country由来。国籍ではない）。既知値: domestic / foreign。実測で第3区分コードが存在するためopen（値マッピングは実装Issueで確定）"},"invoice":{"$ref":"#/components/schemas/InvoiceBlock"},"kind":{"enum":["corporation","individual"],"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}]},"name_kana":{"anyOf":[{"type":"string"},{"type":"null"}]},"popular_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"通称または旧姓（NTA popularName_previousName由来）"},"revision":{"anyOf":[{"$ref":"#/components/schemas/Revision"},{"type":"null"}]},"trade_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"屋号（NTA公表分のみ実値）"},"updated_at":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]}},"required":["kind","corporate_number","name","name_kana","name_en","trade_name","popular_name","country","address","address_request","address_inside","address_outside","active","closure","assignment_date","updated_at","revision","invoice"],"type":"object"},"InvoiceValidity":{"properties":{"cancel_date":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]},"date":{"description":"実際に評価した基準日","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},"expire_date":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]},"registration_date":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]},"registration_number":{"pattern":"^T\\d{13}$","type":"string"},"valid":{"type":"boolean"}},"required":["registration_number","date","valid","registration_date","cancel_date","expire_date"],"type":"object"},"LimitInfo":{"oneOf":[{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"unlimited":{"const":false,"type":"boolean"}},"required":["unlimited","limit","remaining"],"type":"object"},{"properties":{"limit":{"type":"null"},"remaining":{"type":"null"},"unlimited":{"const":true,"type":"boolean"}},"required":["unlimited","limit","remaining"],"type":"object"}]},"Links":{"description":"関連操作キーはエンドポイント別の固定セット（各operationでrequired指定・値なしはnull常設）。キー追加は非破壊","properties":{"company":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}],"description":"invoice系のみ。個人等で対応法人なしはnull"},"docs":{"format":"uri","type":"string"},"download":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}],"description":"batch系のみ。completed前はnull"},"invoice":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}],"description":"companies系およびinvoice_validで使用。未登録はnull"},"next":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}],"description":"一覧のみ。最終ページ/打ち切り時はnull"},"self":{"format":"uri","type":"string"},"status":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}],"description":"batch match 202のみ"}},"required":["self","docs"],"type":"object"},"ListEnvelope":{"properties":{"data":{"items":{},"type":"array"},"has_more":{"description":"続きの実在を示す。offset+limitが上限1000に達した場合、has_more=trueでも links.next はnull（打ち切り。1000件超の走査は非対応）","type":"boolean"},"item":{"type":"string"},"limit":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/Meta"},"object":{"const":"list","type":"string"},"offset":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"schema_version":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}},"required":["object","item","schema_version","data","has_more","offset","limit","links","meta"],"type":"object"},"Meta":{"properties":{"quota":{"properties":{"api_requests":{"$ref":"#/components/schemas/LimitInfo"},"batch_rows":{"anyOf":[{"$ref":"#/components/schemas/LimitInfo"},{"type":"null"}],"description":"batch系エンドポイントのみnon-null"}},"required":["api_requests","batch_rows"],"type":"object"},"rate_limit":{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"reset":{"description":"ウィンドウリセット時刻","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","type":"string"},"unlimited":{"const":false,"description":"rpmは全プラン有限のため常にfalse","type":"boolean"}},"required":["unlimited","limit","remaining","reset"],"type":"object"},"source":{"properties":{"name":{"const":"nta","type":"string"},"updated_at":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}],"description":"単体取得=当該レコードのNTA更新日。一覧・batch系ではnull"}},"required":["name","updated_at"],"type":"object"}},"required":["source","rate_limit","quota"],"type":"object"},"Problem":{"properties":{"code":{"description":"サーバー出力を束縛する閉じたenum（17種）。追加は非破壊（enum更新+schema_version更新）。クライアント生成はcatch-all必須","enum":["VALIDATION_ERROR","UNAUTHORIZED","FORBIDDEN","PLAN_UPGRADE_REQUIRED","IDEMPOTENCY_CONFLICT","BILLING_CONFLICT","ACCOUNT_DELETION_BLOCKED","ACCOUNT_ALREADY_DELETED","ACCOUNT_REAUTH_REQUIRED","BATCH_NOT_COMPLETED","BATCH_FAILED","NOT_FOUND","NOT_IMPLEMENTED","RATE_LIMIT_EXCEEDED","QUOTA_EXCEEDED","DEPENDENCY_UNAVAILABLE","INTERNAL_ERROR"],"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"発生個別の説明。なければnull（常設null規則をエラーにも適用）"},"details":{"anyOf":[{"items":{"properties":{"code":{"description":"サーバー出力を束縛する閉じたenum。追加は非破壊・クライアント生成はcatch-all必須","enum":["required","format","range","unsupported_value"],"type":"string"},"field":{"description":"JSON Pointer または query/path パラメータ名","type":"string"},"message":{"type":"string"}},"required":["field","code","message"],"type":"object"},"type":"array"},{"type":"null"}],"description":"VALIDATION_ERROR時のみnon-null"},"limit_scope":{"anyOf":[{"enum":["rpm","api_requests","batch_rows"],"type":"string"},{"type":"null"}],"description":"429系のみnon-null"},"retry_after":{"anyOf":[{"maximum":9007199254740991,"minimum":0,"type":"integer"},{"type":"null"}],"description":"秒。retryable=false時は常にnull"},"retryable":{"type":"boolean"},"status":{"description":"HTTPステータスコードと常に一致（契約テスト対象）","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"title":{"description":"codeと1対1の固定文言","type":"string"},"type":{"description":"コード別docsアンカー。codeと1対1固定","format":"uri","type":"string"}},"required":["type","title","status","detail","code","limit_scope","retryable","retry_after","details"],"type":"object"},"RateLimitProblem":{"properties":{"code":{"enum":["RATE_LIMIT_EXCEEDED","QUOTA_EXCEEDED"],"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"発生個別の説明。なければnull（常設null規則をエラーにも適用）"},"details":{"anyOf":[{"items":{"properties":{"code":{"description":"サーバー出力を束縛する閉じたenum。追加は非破壊・クライアント生成はcatch-all必須","enum":["required","format","range","unsupported_value"],"type":"string"},"field":{"description":"JSON Pointer または query/path パラメータ名","type":"string"},"message":{"type":"string"}},"required":["field","code","message"],"type":"object"},"type":"array"},{"type":"null"}],"description":"VALIDATION_ERROR時のみnon-null"},"limit_scope":{"enum":["rpm","api_requests","batch_rows"],"type":"string"},"retry_after":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"retryable":{"const":true,"type":"boolean"},"status":{"description":"HTTPステータスコードと常に一致（契約テスト対象）","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"title":{"description":"codeと1対1の固定文言","type":"string"},"type":{"description":"コード別docsアンカー。codeと1対1固定","format":"uri","type":"string"}},"required":["type","title","status","detail","code","limit_scope","retryable","retry_after","details"],"type":"object"},"Revision":{"properties":{"change_cause":{"anyOf":[{"type":"string"},{"type":"null"}]},"change_date":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]},"correct":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"latest":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"最新レコード判定（NTA latest由来）"},"process":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"NTA変更事由コード"},"published_date":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}]},"sequence_number":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]}},"required":["sequence_number","published_date","change_date","process","correct","change_cause","latest"],"type":"object"}},"securitySchemes":{"ApiKeyAuth":{"in":"header","name":"x-api-key","type":"apiKey"}}},"info":{"description":"法人番号・適格請求書発行事業者（インボイス）公開データAPI。\n全成功レスポンスは共通エンベロープ（object/schema_version/data/links/meta）。\nエラーは RFC 9457 (application/problem+json)。\nクライアント規約: 未知フィールド・未知enum値を無視すること（フィールド追加・enum値追加は非破壊）。\n本ドラフトのenumは既知値の列挙であり、コード生成時は未知値を受容するcatch-all表現（open enum）とすること。\nエンベロープの例外は batch download の format=csv（text/csv直返し）とエラー（problem+json）のみ。\nobject=batch_job は 202 のack形（BatchJobQueuedAck）と状態取得の資源形（BatchJob）の2形を持つ。","title":"Bango API 公開データエンドポイント","version":"2026-08"},"openapi":"3.1.0","paths":{"/batch/match":{"post":{"description":"企業名の名寄せバッチを投入し 202 で job_id を返す。Idempotency-Key はAPIキー単位スコープ・TTL 24時間で、同一キー+同一payload再送は初回応答を再生（quota再消費なし）、payload不一致は 409。","operationId":"batch_match","parameters":[{"description":"APIキー単位スコープ・TTL 24時間。同一キー+同一payload再送は初回202を再生（同一job_id・quota再消費なし）。payload不一致は 409 IDEMPOTENCY_CONFLICT。failedジョブ再投入時はキーを変更または省略すること。","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":64,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"companies":["サンプル商事",{"company_name":"テスト工業","prefecture_code":"27"}]},"schema":{"properties":{"companies":{"items":{"oneOf":[{"description":"企業名のみの簡易指定。前後空白トリム後1文字以上（空・空白のみはVALIDATION_ERROR）","maxLength":200,"minLength":1,"pattern":"\\S","type":"string"},{"anyOf":[{"required":["name"]},{"required":["company_name"]}],"properties":{"company_name":{"description":"name の別名キー。両指定時はnameが優先","maxLength":200,"minLength":1,"pattern":"\\S","type":"string"},"name":{"maxLength":200,"minLength":1,"pattern":"\\S","type":"string"},"prefecture_code":{"pattern":"^\\d{2}$","type":"string"}},"type":"object"}]},"maxItems":1000,"minItems":1,"type":"array"}},"required":["companies"],"type":"object"}},"multipart/form-data":{"schema":{"properties":{"file":{"description":"CSVファイル（最大1,000データ行・サイズはHTTPボディ5MB上限に含む）。ヘッダー行必須・列 name（または company_name）と任意列 prefecture_code","format":"binary","type":"string"}},"required":["file"],"type":"object"}}},"description":"JSON/CSVともボディ5MB上限（超過は413）。","required":true},"responses":{"202":{"content":{"application/json":{"example":{"data":{"job_id":"4ccdb8ca-f2c9-424d-a59a-fa67e4f73152","status":"queued"},"links":{"docs":"https://bango-api.jp/docs#batch_match","self":"https://api.bango-api.jp/v1/batch/match","status":"https://api.bango-api.jp/v1/batch/4ccdb8ca-f2c9-424d-a59a-fa67e4f73152"},"meta":{"quota":{"api_requests":{"limit":60000,"remaining":59987,"unlimited":false},"batch_rows":{"limit":100000,"remaining":99000,"unlimited":false}},"rate_limit":{"limit":600,"remaining":599,"reset":"2026-05-14T02:31:00Z","unlimited":false},"source":{"name":"nta","updated_at":null}},"object":"batch_job","schema_version":"2026-08"},"schema":{"properties":{"data":{"$ref":"#/components/schemas/BatchJobQueuedAck"},"links":{"properties":{"docs":{"format":"uri","type":"string"},"self":{"format":"uri","type":"string"},"status":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]}},"required":["self","docs","status"],"type":"object"},"meta":{"properties":{"quota":{"properties":{"api_requests":{"$ref":"#/components/schemas/LimitInfo"},"batch_rows":{"anyOf":[{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"unlimited":{"const":false,"type":"boolean"}},"required":["unlimited","limit","remaining"],"type":"object"},{"properties":{"limit":{"type":"null"},"remaining":{"type":"null"},"unlimited":{"const":true,"type":"boolean"}},"required":["unlimited","limit","remaining"],"type":"object"}],"description":"batch系エンドポイントのみnon-null"}},"required":["api_requests","batch_rows"],"type":"object"},"rate_limit":{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"reset":{"description":"ウィンドウリセット時刻","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","type":"string"},"unlimited":{"const":false,"description":"rpmは全プラン有限のため常にfalse","type":"boolean"}},"required":["unlimited","limit","remaining","reset"],"type":"object"},"source":{"properties":{"name":{"const":"nta","type":"string"},"updated_at":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}],"description":"単体取得=当該レコードのNTA更新日。一覧・batch系ではnull"}},"required":["name","updated_at"],"type":"object"}},"required":["source","rate_limit","quota"],"type":"object"},"object":{"const":"batch_job","type":"string"},"schema_version":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}},"required":["object","schema_version","data","links","meta"],"type":"object"}}},"description":"受付済み","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitProblem"}}},"description":"レート制限・クォータ超過（RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED。limit_scope・retry_after必須）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"依存障害（DEPENDENCY_UNAVAILABLE）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"エラー（RFC 9457）。401等プラン特定不能な応答ではX-RateLimit-*/X-Quota-*を送出しない（Cache-Controlのみ）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}}},"summary":"名寄せバッチ投入"}},"/batch/{job_id}":{"get":{"description":"job_id でジョブの状態・進捗と件数集計（summary）を参照する。結果全件は含まず、取得は download エンドポイントへ誘導する。","operationId":"batch_status","parameters":[{"in":"path","name":"job_id","required":true,"schema":{"maxLength":64,"minLength":1,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"error":null,"job_id":"4ccdb8ca-f2c9-424d-a59a-fa67e4f73152","progress":{"done":1,"total":1},"status":"completed","summary":{"confident":1,"review":0,"unmatched":0}},"links":{"docs":"https://bango-api.jp/docs#batch_status","download":"https://api.bango-api.jp/v1/batch/4ccdb8ca-f2c9-424d-a59a-fa67e4f73152/download","self":"https://api.bango-api.jp/v1/batch/4ccdb8ca-f2c9-424d-a59a-fa67e4f73152"},"meta":{"quota":{"api_requests":{"limit":60000,"remaining":59987,"unlimited":false},"batch_rows":{"limit":100000,"remaining":99000,"unlimited":false}},"rate_limit":{"limit":600,"remaining":599,"reset":"2026-05-14T02:31:00Z","unlimited":false},"source":{"name":"nta","updated_at":null}},"object":"batch_job","schema_version":"2026-08"},"schema":{"properties":{"data":{"$ref":"#/components/schemas/BatchJob"},"links":{"properties":{"docs":{"format":"uri","type":"string"},"download":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"self":{"format":"uri","type":"string"}},"required":["self","docs","download"],"type":"object"},"meta":{"properties":{"quota":{"properties":{"api_requests":{"$ref":"#/components/schemas/LimitInfo"},"batch_rows":{"anyOf":[{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"unlimited":{"const":false,"type":"boolean"}},"required":["unlimited","limit","remaining"],"type":"object"},{"properties":{"limit":{"type":"null"},"remaining":{"type":"null"},"unlimited":{"const":true,"type":"boolean"}},"required":["unlimited","limit","remaining"],"type":"object"}],"description":"batch系エンドポイントのみnon-null"}},"required":["api_requests","batch_rows"],"type":"object"},"rate_limit":{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"reset":{"description":"ウィンドウリセット時刻","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","type":"string"},"unlimited":{"const":false,"description":"rpmは全プラン有限のため常にfalse","type":"boolean"}},"required":["unlimited","limit","remaining","reset"],"type":"object"},"source":{"properties":{"name":{"const":"nta","type":"string"},"updated_at":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}],"description":"単体取得=当該レコードのNTA更新日。一覧・batch系ではnull"}},"required":["name","updated_at"],"type":"object"}},"required":["source","rate_limit","quota"],"type":"object"},"object":{"const":"batch_job","type":"string"},"schema_version":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}},"required":["object","schema_version","data","links","meta"],"type":"object"}}},"description":"ジョブ状態","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitProblem"}}},"description":"レート制限・クォータ超過（RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED。limit_scope・retry_after必須）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"依存障害（DEPENDENCY_UNAVAILABLE）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"エラー（RFC 9457）。401等プラン特定不能な応答ではX-RateLimit-*/X-Quota-*を送出しない（Cache-Controlのみ）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}}},"summary":"バッチ状態取得（completedでもresultsは返さない。全件はdownloadへ）"}},"/batch/{job_id}/download":{"get":{"description":"MCP tool実装は原則 status（summary）を参照させ、全件の直接取り込み（コンテキスト溢れ）を避けること。format=csv は Content-Type: text/csv（UTF-8 BOM・列順固定・数式インジェクション無害化）でエンベロープ対象外。","operationId":"batch_download","parameters":[{"in":"path","name":"job_id","required":true,"schema":{"maxLength":64,"minLength":1,"type":"string"}},{"in":"query","name":"format","required":false,"schema":{"default":"json","enum":["json","csv"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"candidate_count":1,"candidates":[{"corporate_number":"1234567890123","name":"株式会社サンプル","name_kana":"カブシキガイシャサンプル","score":0.97}],"confidence":"confident","input_name":"サンプル商事","matched_corporate_number":"1234567890123","object":"batch_result_row","prefecture_code":"13","row_index":1,"score":0.97}],"has_more":false,"item":"batch_result_row","limit":1,"links":{"docs":"https://bango-api.jp/docs#batch_download","self":"https://api.bango-api.jp/v1/batch/4ccdb8ca-f2c9-424d-a59a-fa67e4f73152/download"},"meta":{"quota":{"api_requests":{"limit":60000,"remaining":59987,"unlimited":false},"batch_rows":{"limit":100000,"remaining":99000,"unlimited":false}},"rate_limit":{"limit":600,"remaining":599,"reset":"2026-05-14T02:31:00Z","unlimited":false},"source":{"name":"nta","updated_at":null}},"object":"list","offset":0,"schema_version":"2026-08"},"schema":{"properties":{"data":{"items":{"$ref":"#/components/schemas/BatchResultRow"},"type":"array"},"has_more":{"description":"続きの実在を示す。offset+limitが上限1000に達した場合、has_more=trueでも links.next はnull（打ち切り。1000件超の走査は非対応）","type":"boolean"},"item":{"const":"batch_result_row","type":"string"},"limit":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"links":{"properties":{"docs":{"format":"uri","type":"string"},"self":{"format":"uri","type":"string"}},"required":["self","docs"],"type":"object"},"meta":{"properties":{"quota":{"properties":{"api_requests":{"$ref":"#/components/schemas/LimitInfo"},"batch_rows":{"anyOf":[{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"unlimited":{"const":false,"type":"boolean"}},"required":["unlimited","limit","remaining"],"type":"object"},{"properties":{"limit":{"type":"null"},"remaining":{"type":"null"},"unlimited":{"const":true,"type":"boolean"}},"required":["unlimited","limit","remaining"],"type":"object"}],"description":"batch系エンドポイントのみnon-null"}},"required":["api_requests","batch_rows"],"type":"object"},"rate_limit":{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"reset":{"description":"ウィンドウリセット時刻","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","type":"string"},"unlimited":{"const":false,"description":"rpmは全プラン有限のため常にfalse","type":"boolean"}},"required":["unlimited","limit","remaining","reset"],"type":"object"},"source":{"properties":{"name":{"const":"nta","type":"string"},"updated_at":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}],"description":"単体取得=当該レコードのNTA更新日。一覧・batch系ではnull"}},"required":["name","updated_at"],"type":"object"}},"required":["source","rate_limit","quota"],"type":"object"},"object":{"const":"list","type":"string"},"offset":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"schema_version":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}},"required":["object","item","schema_version","data","has_more","offset","limit","links","meta"],"type":"object"}},"text/csv":{"schema":{"type":"string"}}},"description":"結果全件","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitProblem"}}},"description":"レート制限・クォータ超過（RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED。limit_scope・retry_after必須）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"依存障害（DEPENDENCY_UNAVAILABLE）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"エラー（RFC 9457）。401等プラン特定不能な応答ではX-RateLimit-*/X-Quota-*を送出しない（Cache-Controlのみ）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}}},"summary":"バッチ結果全件取得（resultsの唯一の提供元）"}},"/companies/search":{"get":{"description":"スコア降順（同点は corporate_number 昇順のtie-breaker）で安定ソート。","operationId":"companies_search","parameters":[{"in":"query","name":"q","required":true,"schema":{"maxLength":200,"minLength":1,"pattern":"\\S","type":"string"}},{"description":"exactは正規化後の完全一致","in":"query","name":"mode","required":false,"schema":{"default":"partial","enum":["partial","exact"],"type":"string"}},{"description":"falseで表記ゆれ吸収なしの原文一致","in":"query","name":"normalize","required":false,"schema":{"default":true,"type":"boolean"}},{"in":"query","name":"prefecture_code","required":false,"schema":{"pattern":"^[0-9]{2}$","type":"string"}},{"in":"query","name":"city_code","required":false,"schema":{"pattern":"^[0-9]{5}$","type":"string"}},{"in":"query","name":"post_code","required":false,"schema":{"pattern":"^[0-9]{7}$","type":"string"}},{"description":"フリガナ部分一致","in":"query","name":"name_kana","required":false,"schema":{"maxLength":200,"type":"string"}},{"description":"英語名部分一致","in":"query","name":"name_en","required":false,"schema":{"maxLength":300,"type":"string"}},{"description":"prefecture,kind,active からカンマ区切り指定。重複指定はVALIDATION_ERROR（patternは軸名/個数のみ保証・重複検査は実装バリデーション）。指定時のみ集計し、集計母集団はページング前の全一致集合。レスポンスfacetsに返す","in":"query","name":"facets","required":false,"schema":{"pattern":"^(prefecture|kind|active)(,(prefecture|kind|active)){0,2}$","type":"string"}},{"description":"1〜100。既定10。","in":"query","name":"limit","required":false,"schema":{"default":10,"maximum":100,"minimum":1,"type":"integer"}},{"description":"0〜999。既定0。offset+limit<=1000 を実装バリデーションで強制（超過はVALIDATION_ERROR）。","in":"query","name":"offset","required":false,"schema":{"default":0,"maximum":999,"minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"city_code":"23211","corporate_number":"1180301018771","name":"トヨタ自動車株式会社","name_kana":"トヨタジドウシャ","object":"company_summary","prefecture_code":"23","score":0.857143},{"city_code":"01213","corporate_number":"1430005009042","name":"トヨタ自動車北海道労働組合","name_kana":"トヨタジドウシャホッカイドウ","object":"company_summary","prefecture_code":"01","score":0.857143}],"facets":null,"has_more":true,"item":"company_summary","limit":2,"links":{"docs":"https://bango-api.jp/docs#companies_search","next":"https://api.bango-api.jp/v1/companies/search?q=%E3%83%88%E3%83%A8%E3%82%BF%E8%87%AA%E5%8B%95%E8%BB%8A&limit=2&offset=2","self":"https://api.bango-api.jp/v1/companies/search?q=%E3%83%88%E3%83%A8%E3%82%BF%E8%87%AA%E5%8B%95%E8%BB%8A&limit=2"},"meta":{"quota":{"api_requests":{"limit":60000,"remaining":59987,"unlimited":false},"batch_rows":null},"rate_limit":{"limit":600,"remaining":599,"reset":"2026-05-14T02:31:00Z","unlimited":false},"source":{"name":"nta","updated_at":null}},"object":"list","offset":0,"schema_version":"2026-08"},"schema":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CompanySummary"},"type":"array"},"facets":{"anyOf":[{"additionalProperties":{"items":{"properties":{"count":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"type":"array"},"propertyNames":{"type":"string"},"type":"object"},{"type":"null"}],"description":"facetsパラメータ指定時のみnon-null（軸名→{value,count}[]）"},"has_more":{"description":"続きの実在を示す。offset+limitが上限1000に達した場合、has_more=trueでも links.next はnull（打ち切り。1000件超の走査は非対応）","type":"boolean"},"item":{"const":"company_summary","type":"string"},"limit":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"links":{"properties":{"docs":{"format":"uri","type":"string"},"next":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"self":{"format":"uri","type":"string"}},"required":["self","docs","next"],"type":"object"},"meta":{"properties":{"quota":{"properties":{"api_requests":{"$ref":"#/components/schemas/LimitInfo"},"batch_rows":{"description":"非batch系エンドポイントでは常にnull","type":"null"}},"required":["api_requests","batch_rows"],"type":"object"},"rate_limit":{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"reset":{"description":"ウィンドウリセット時刻","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","type":"string"},"unlimited":{"const":false,"description":"rpmは全プラン有限のため常にfalse","type":"boolean"}},"required":["unlimited","limit","remaining","reset"],"type":"object"},"source":{"properties":{"name":{"const":"nta","type":"string"},"updated_at":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}],"description":"単体取得=当該レコードのNTA更新日。一覧・batch系ではnull"}},"required":["name","updated_at"],"type":"object"}},"required":["source","rate_limit","quota"],"type":"object"},"object":{"const":"list","type":"string"},"offset":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"schema_version":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}},"required":["object","item","schema_version","data","has_more","offset","limit","links","meta","facets"],"type":"object"}}},"description":"検索結果一覧","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitProblem"}}},"description":"レート制限・クォータ超過（RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED。limit_scope・retry_after必須）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"依存障害（DEPENDENCY_UNAVAILABLE）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"エラー（RFC 9457）。401等プラン特定不能な応答ではX-RateLimit-*/X-Quota-*を送出しない（Cache-Controlのみ）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}}},"summary":"企業名検索"}},"/companies/{corporate_number}":{"get":{"description":"13桁の法人番号で単体の企業情報を取得。links に invoice を必須で含む（未登録は null）。","operationId":"companies_lookup","parameters":[{"in":"path","name":"corporate_number","required":true,"schema":{"pattern":"^[0-9]{13}$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"active":true,"address":{"city":"豊田市","city_code":"23211","city_en":null,"full":"愛知県豊田市トヨタ町１番地","image_id":null,"post_code":"4710826","prefecture":"愛知県","prefecture_code":"23","prefecture_en":null,"street":"トヨタ町１番地"},"address_outside":null,"assignment_date":"2015-10-05","closure":null,"corporate_number":"1180301018771","invoice":{"cancel_date":null,"country":"domestic","expire_date":null,"found":true,"registered":true,"registration_date":"2023-10-01","registration_number":"T1180301018771","valid":true},"kind":"株式会社","kind_code":"301","name":"トヨタ自動車株式会社","name_en":null,"name_image_id":null,"name_kana":"トヨタジドウシャ","revision":{"change_cause":null,"change_date":null,"correct":null,"latest":null,"process":null,"published_date":null,"sequence_number":null},"search_excluded":null,"updated_at":"2019-04-23"},"links":{"docs":"https://bango-api.jp/docs#companies_lookup","invoice":"https://api.bango-api.jp/v1/invoice/T1180301018771","self":"https://api.bango-api.jp/v1/companies/1180301018771"},"meta":{"quota":{"api_requests":{"limit":60000,"remaining":59987,"unlimited":false},"batch_rows":null},"rate_limit":{"limit":600,"remaining":599,"reset":"2026-05-14T02:31:00Z","unlimited":false},"source":{"name":"nta","updated_at":"2019-04-23"}},"object":"company","schema_version":"2026-08"},"schema":{"properties":{"data":{"$ref":"#/components/schemas/Company"},"links":{"properties":{"docs":{"format":"uri","type":"string"},"invoice":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"self":{"format":"uri","type":"string"}},"required":["self","docs","invoice"],"type":"object"},"meta":{"properties":{"quota":{"properties":{"api_requests":{"$ref":"#/components/schemas/LimitInfo"},"batch_rows":{"description":"非batch系エンドポイントでは常にnull","type":"null"}},"required":["api_requests","batch_rows"],"type":"object"},"rate_limit":{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"reset":{"description":"ウィンドウリセット時刻","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","type":"string"},"unlimited":{"const":false,"description":"rpmは全プラン有限のため常にfalse","type":"boolean"}},"required":["unlimited","limit","remaining","reset"],"type":"object"},"source":{"properties":{"name":{"const":"nta","type":"string"},"updated_at":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}],"description":"単体取得=当該レコードのNTA更新日。一覧・batch系ではnull"}},"required":["name","updated_at"],"type":"object"}},"required":["source","rate_limit","quota"],"type":"object"},"object":{"const":"company","type":"string"},"schema_version":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}},"required":["object","schema_version","data","links","meta"],"type":"object"}}},"description":"企業情報","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitProblem"}}},"description":"レート制限・クォータ超過（RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED。limit_scope・retry_after必須）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"依存障害（DEPENDENCY_UNAVAILABLE）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"エラー（RFC 9457）。401等プラン特定不能な応答ではX-RateLimit-*/X-Quota-*を送出しない（Cache-Controlのみ）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}}},"summary":"法人番号による企業情報取得"}},"/invoice/{registration_number}":{"get":{"description":"登録番号（T+13桁）で適格請求書発行事業者情報を取得。法人・個人でレスポンスは完全同形。links に company を必須で含む（対応法人なしは null）。","operationId":"invoice_lookup","parameters":[{"in":"path","name":"registration_number","required":true,"schema":{"pattern":"^T[0-9]{13}$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"active":true,"address":{"city":"豊田市","city_code":"23211","city_en":null,"full":"愛知県豊田市トヨタ町１番地","image_id":null,"post_code":"4710826","prefecture":"愛知県","prefecture_code":"23","prefecture_en":null,"street":"トヨタ町１番地"},"address_inside":null,"address_outside":null,"address_request":null,"assignment_date":"2015-10-05","closure":null,"corporate_number":"1180301018771","country":"domestic","invoice":{"cancel_date":null,"country":"domestic","expire_date":null,"found":true,"registered":true,"registration_date":"2023-10-01","registration_number":"T1180301018771","valid":true},"kind":"corporation","name":"トヨタ自動車株式会社","name_en":null,"name_kana":"トヨタジドウシャ","popular_name":null,"revision":null,"trade_name":null,"updated_at":"2021-10-28"},"links":{"company":"https://api.bango-api.jp/v1/companies/1180301018771","docs":"https://bango-api.jp/docs#invoice_lookup","self":"https://api.bango-api.jp/v1/invoice/T1180301018771"},"meta":{"quota":{"api_requests":{"limit":60000,"remaining":59987,"unlimited":false},"batch_rows":null},"rate_limit":{"limit":600,"remaining":599,"reset":"2026-05-14T02:31:00Z","unlimited":false},"source":{"name":"nta","updated_at":"2021-10-28"}},"object":"invoice_issuer","schema_version":"2026-08"},"schema":{"properties":{"data":{"$ref":"#/components/schemas/InvoiceIssuer"},"links":{"properties":{"company":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"docs":{"format":"uri","type":"string"},"self":{"format":"uri","type":"string"}},"required":["self","docs","company"],"type":"object"},"meta":{"properties":{"quota":{"properties":{"api_requests":{"$ref":"#/components/schemas/LimitInfo"},"batch_rows":{"description":"非batch系エンドポイントでは常にnull","type":"null"}},"required":["api_requests","batch_rows"],"type":"object"},"rate_limit":{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"reset":{"description":"ウィンドウリセット時刻","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","type":"string"},"unlimited":{"const":false,"description":"rpmは全プラン有限のため常にfalse","type":"boolean"}},"required":["unlimited","limit","remaining","reset"],"type":"object"},"source":{"properties":{"name":{"const":"nta","type":"string"},"updated_at":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}],"description":"単体取得=当該レコードのNTA更新日。一覧・batch系ではnull"}},"required":["name","updated_at"],"type":"object"}},"required":["source","rate_limit","quota"],"type":"object"},"object":{"const":"invoice_issuer","type":"string"},"schema_version":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}},"required":["object","schema_version","data","links","meta"],"type":"object"}}},"description":"発行事業者情報","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitProblem"}}},"description":"レート制限・クォータ超過（RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED。limit_scope・retry_after必須）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"依存障害（DEPENDENCY_UNAVAILABLE）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"エラー（RFC 9457）。401等プラン特定不能な応答ではX-RateLimit-*/X-Quota-*を送出しない（Cache-Controlのみ）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}}},"summary":"適格請求書発行事業者情報取得（法人/個人 完全同形）"}},"/invoice/{registration_number}/valid":{"get":{"description":"登録番号が指定基準日時点で有効かを判定。date 省略時は Asia/Tokyo の当日で評価し、実際に評価した日付を data.date に返す。","operationId":"invoice_valid","parameters":[{"in":"path","name":"registration_number","required":true,"schema":{"pattern":"^T[0-9]{13}$","type":"string"}},{"description":"判定基準日。省略時は Asia/Tokyo の当日。応答の data.date は実際に評価した日付。","in":"query","name":"date","required":false,"schema":{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cancel_date":null,"date":"2024-10-01","expire_date":null,"registration_date":"2023-10-01","registration_number":"T1180301018771","valid":true},"links":{"docs":"https://bango-api.jp/docs#invoice_valid","invoice":"https://api.bango-api.jp/v1/invoice/T1180301018771","self":"https://api.bango-api.jp/v1/invoice/T1180301018771/valid"},"meta":{"quota":{"api_requests":{"limit":60000,"remaining":59987,"unlimited":false},"batch_rows":null},"rate_limit":{"limit":600,"remaining":599,"reset":"2026-05-14T02:31:00Z","unlimited":false},"source":{"name":"nta","updated_at":"2021-10-28"}},"object":"invoice_validity","schema_version":"2026-08"},"schema":{"properties":{"data":{"$ref":"#/components/schemas/InvoiceValidity"},"links":{"properties":{"docs":{"format":"uri","type":"string"},"invoice":{"anyOf":[{"format":"uri","type":"string"},{"type":"null"}]},"self":{"format":"uri","type":"string"}},"required":["self","docs","invoice"],"type":"object"},"meta":{"properties":{"quota":{"properties":{"api_requests":{"$ref":"#/components/schemas/LimitInfo"},"batch_rows":{"description":"非batch系エンドポイントでは常にnull","type":"null"}},"required":["api_requests","batch_rows"],"type":"object"},"rate_limit":{"properties":{"limit":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"remaining":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"reset":{"description":"ウィンドウリセット時刻","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","type":"string"},"unlimited":{"const":false,"description":"rpmは全プラン有限のため常にfalse","type":"boolean"}},"required":["unlimited","limit","remaining","reset"],"type":"object"},"source":{"properties":{"name":{"const":"nta","type":"string"},"updated_at":{"anyOf":[{"format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","type":"string"},{"type":"null"}],"description":"単体取得=当該レコードのNTA更新日。一覧・batch系ではnull"}},"required":["name","updated_at"],"type":"object"}},"required":["source","rate_limit","quota"],"type":"object"},"object":{"const":"invoice_validity","type":"string"},"schema_version":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}},"required":["object","schema_version","data","links","meta"],"type":"object"}}},"description":"有効性判定結果","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitProblem"}}},"description":"レート制限・クォータ超過（RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED。limit_scope・retry_after必須）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"依存障害（DEPENDENCY_UNAVAILABLE）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"エラー（RFC 9457）。401等プラン特定不能な応答ではX-RateLimit-*/X-Quota-*を送出しない（Cache-Controlのみ）","headers":{"Cache-Control":{"$ref":"#/components/headers/CacheControl"},"X-Quota-Limit":{"$ref":"#/components/headers/XQuotaLimit"},"X-Quota-Remaining":{"$ref":"#/components/headers/XQuotaRemaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}}},"summary":"登録番号の有効性判定"}}},"security":[{"ApiKeyAuth":[]}],"servers":[{"url":"https://api.bango-api.jp/v1"}]}