{"openapi":"3.1.0","info":{"title":"営業GO! 会社データ API","version":"1.0.0","description":"日本の会社を法人番号で取得する API。出所を確認できたデータだけを返します。1社50円（税別・前払い）、毎月20社まで無料、同じ会社の30日以内の再取得は無料。社名検索は無料。MCP サーバーは https://eigyo-go.com/mcp。説明: https://eigyo-go.com/developers"},"servers":[{"url":"https://eigyo-go.com"}],"security":[{"bearerAuth":[]}],"paths":{"/api/v1/companies/search":{"get":{"operationId":"searchCompanies","summary":"社名で会社を探す（無料）","description":"候補は最大20社。各社に取得できる項目の有無（available）を返す。キー1つにつき1分60回まで。","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":60},"description":"社名（2文字以上）"},{"name":"prefecture","in":"query","required":false,"schema":{"type":"string"},"description":"都道府県名（例: 東京都）"}],"responses":{"200":{"description":"候補","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"q が短い・長い","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"キーが無い・無効","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"呼び出しが多すぎる","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/companies/{corporateNumber}":{"get":{"operationId":"getCompany","summary":"会社のデータを取得する（1社50円・税別）","description":"その会社にある、出所を確認できたデータを全部返す。今月の無料枠（20社）と、同じ会社の30日以内の再取得は0円。会社が無い・残高不足のときは課金しない。キー1つにつき1分30回まで。","parameters":[{"name":"corporateNumber","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{13}$"},"description":"法人番号（13桁）"}],"responses":{"200":{"description":"会社のデータ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyResponse"}}}},"400":{"description":"法人番号の形式が違う","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"キーが無い・無効","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"残高不足（topup_url でチャージ）","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"該当する会社が無い","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"呼び出しが多すぎる","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/balance":{"get":{"operationId":"getBalance","summary":"残高と無料枠を確認する（無料）","responses":{"200":{"description":"残高","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BalanceResponse"}}}},"401":{"description":"キーが無い・無効","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/demo/{corporateNumber}":{"get":{"operationId":"getDemoCompany","summary":"見本の会社を取得する（キー不要・無料）","description":"見本の3社だけ。実際の取得と同じ形で全項目が入っている。","security":[],"parameters":[{"name":"corporateNumber","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{13}$"}}],"responses":{"200":{"description":"見本","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyResponse"}}}},"404":{"description":"見本の会社ではない","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"呼び出しが多すぎる","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Authorization: Bearer egk_...（https://eigyo-go.com/developers/start でメールアドレスだけで発行）"}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","next_step"],"properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key","invalid_corporate_number","company_not_found","insufficient_balance","rate_limited","invalid_query","internal_error","demo_only"]},"message":{"type":"string"},"next_step":{"type":"string","description":"次にすること"},"topup_url":{"type":"string"},"signup_url":{"type":"string"},"retry_after_seconds":{"type":"integer"}}}}},"SearchResponse":{"type":"object","required":["query","count","charged_jpy","results"],"properties":{"query":{"type":"string"},"prefecture":{"type":["string","null"]},"count":{"type":"integer"},"limit":{"type":"integer"},"charged_jpy":{"const":0},"results":{"type":"array","items":{"type":"object","required":["corporate_number","company_name","available","price_jpy"],"properties":{"corporate_number":{"type":"string"},"company_name":{"type":"string"},"prefecture":{"type":["string","null"]},"city":{"type":["string","null"]},"price_jpy":{"const":50},"available":{"type":"object","properties":{"financials":{"type":"boolean"},"public_records":{"type":"boolean"},"change_history":{"type":"boolean"},"business_description":{"type":"boolean"},"contact":{"type":"boolean"}}}}}},"next_step_ja":{"type":"string"}}},"CompanyResponse":{"type":"object","required":["corporate_number","company_name","summary_ja","cite_as","page_url","charged_jpy","basic","contact","profile","financials","public_records","workplace","website_summary","name_change_history","attribution"],"properties":{"demo":{"type":"boolean","description":"見本のときだけ true"},"corporate_number":{"type":"string"},"company_name":{"type":"string"},"summary_ja":{"type":"string","description":"そのまま引用できる要約（AI 生成ではなく、数字と日付から組んだ文）"},"cite_as":{"type":"string","description":"引用するときの出典表記"},"page_url":{"type":["string","null"],"description":"営業GO!の会社ページ。公開している会社だけ"},"charged_jpy":{"type":"integer","description":"今回引かれた額（税別）"},"charge_reason_ja":{"type":"string"},"balance_jpy":{"type":"integer","description":"残高（税別）"},"free_remaining_this_month":{"type":"integer"},"retrieved_at":{"type":"string","format":"date-time"},"basic":{"type":"object","properties":{"company_name":{"type":"object","description":"商号","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"prefecture":{"type":"object","description":"都道府県","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"city":{"type":"object","description":"市区町村","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"street_address":{"type":"object","description":"町名・番地","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"corporate_type":{"type":"object","description":"法人種別","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}}}},"contact":{"type":"object","description":"出所を確認できた連絡先だけ。確認できないものは null","properties":{"representative_name":{"type":"object","description":"代表者名","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"representative_title":{"type":"object","description":"代表者の肩書き","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"phone":{"type":"object","description":"電話番号","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"fax":{"type":"object","description":"FAX","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"website_url":{"type":"object","description":"公式サイト","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"email":{"type":"object","description":"メール","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}}}},"profile":{"type":"object","properties":{"industry_major":{"type":"object","description":"業種（大分類）","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"industry_mid":{"type":"object","description":"業種（中分類）","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"employee_count":{"type":"object","description":"従業員数（人）","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["integer","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"revenue_range_label":{"type":"object","description":"売上高の区分","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"profit_range_label":{"type":"object","description":"利益の区分","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"capital_jpy":{"type":"object","description":"資本金（円）","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["integer","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}},"established_date":{"type":"object","description":"設立日","required":["value","source","source_url","observed_at","missing_reason"],"properties":{"value":{"type":["string","null"],"description":"値。無いときは null"},"source":{"type":["string","null"],"description":"出典名"},"source_url":{"type":["string","null"],"description":"出典の URL"},"observed_at":{"type":["string","null"],"description":"取得・観測した日（YYYY-MM-DD など）"},"missing_reason":{"type":["string","null"],"description":"value が null のときの理由"}}}}},"financials":{"type":"object","description":"有価証券報告書の主要な経営指標（新しい期が先頭）","required":["available","source","source_url","observed_at","missing_reason","periods","corporate_shareholders"],"properties":{"available":{"type":"boolean","description":"中身があるか"},"source":{"type":["string","null"]},"source_url":{"type":["string","null"]},"observed_at":{"type":["string","null"]},"missing_reason":{"type":["string","null"],"description":"available が false のときの理由"},"periods":{"type":"array","items":{"type":"object","properties":{"fiscal_period_end":{"type":"string","description":"YYYY-MM"},"sales_jpy":{"type":["integer","null"]},"ordinary_income_jpy":{"type":["integer","null"]},"net_income_jpy":{"type":["integer","null"]},"capital_jpy":{"type":["integer","null"]},"net_assets_jpy":{"type":["integer","null"]},"total_assets_jpy":{"type":["integer","null"]},"employees_count":{"type":["integer","null"]}}}},"corporate_shareholders":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"ownership_ratio":{"type":"number"}}}}}},"public_records":{"type":"object","description":"gBizINFO の補助金・調達・届出認定・表彰・特許","required":["available","source","source_url","observed_at","missing_reason","subsidies","procurements","certifications","commendations","patents"],"properties":{"available":{"type":"boolean","description":"中身があるか"},"source":{"type":["string","null"]},"source_url":{"type":["string","null"]},"observed_at":{"type":["string","null"]},"missing_reason":{"type":["string","null"],"description":"available が false のときの理由"},"subsidies":{"type":"object","properties":{"count":{"type":"integer"},"total_amount_jpy":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"date":{"type":["string","null"]},"title":{"type":["string","null"]},"amount_jpy":{"type":["integer","null"]},"department":{"type":["string","null"]},"category":{"type":["string","null"]},"expires":{"type":["string","null"]}}}}}},"procurements":{"type":"object","properties":{"count":{"type":"integer"},"total_amount_jpy":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"date":{"type":["string","null"]},"title":{"type":["string","null"]},"amount_jpy":{"type":["integer","null"]},"department":{"type":["string","null"]},"category":{"type":["string","null"]},"expires":{"type":["string","null"]}}}}}},"certifications":{"type":"object","properties":{"count":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"date":{"type":["string","null"]},"title":{"type":["string","null"]},"amount_jpy":{"type":["integer","null"]},"department":{"type":["string","null"]},"category":{"type":["string","null"]},"expires":{"type":["string","null"]}}}}}},"commendations":{"type":"object","properties":{"count":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"date":{"type":["string","null"]},"title":{"type":["string","null"]},"amount_jpy":{"type":["integer","null"]},"department":{"type":["string","null"]},"category":{"type":["string","null"]},"expires":{"type":["string","null"]}}}}}},"patents":{"type":"object","properties":{"count":{"type":"integer"}}}}},"workplace":{"type":"object","description":"職場情報総合サイトの数値","required":["available","source","source_url","observed_at","missing_reason","average_tenure_years","average_tenure_male_years","average_tenure_female_years","average_age_years","monthly_overtime_hours","female_employee_ratio_percent","female_manager_share_percent","female_officer_share_percent"],"properties":{"available":{"type":"boolean","description":"中身があるか"},"source":{"type":["string","null"]},"source_url":{"type":["string","null"]},"observed_at":{"type":["string","null"]},"missing_reason":{"type":["string","null"],"description":"available が false のときの理由"},"average_tenure_years":{"type":["number","null"]},"average_tenure_male_years":{"type":["number","null"]},"average_tenure_female_years":{"type":["number","null"]},"average_age_years":{"type":["number","null"]},"monthly_overtime_hours":{"type":["number","null"]},"female_employee_ratio_percent":{"type":["number","null"]},"female_manager_share_percent":{"type":["number","null"]},"female_officer_share_percent":{"type":["number","null"]}}},"website_summary":{"type":"object","description":"公式サイトの事業紹介（AI が短い言葉に整理したもの。文章の転載ではない）","required":["available","source","source_url","observed_at","missing_reason","businesses","products_and_services","target_markets","locations_prefecture_level","licenses_and_permits","certifications","history"],"properties":{"available":{"type":"boolean","description":"中身があるか"},"source":{"type":["string","null"]},"source_url":{"type":["string","null"]},"observed_at":{"type":["string","null"]},"missing_reason":{"type":["string","null"],"description":"available が false のときの理由"},"businesses":{"type":"array","items":{"type":"string"}},"products_and_services":{"type":"array","items":{"type":"string"}},"target_markets":{"type":"array","items":{"type":"string"}},"locations_prefecture_level":{"type":"array","items":{"type":"string"}},"licenses_and_permits":{"type":"array","items":{"type":"string"}},"certifications":{"type":"array","items":{"type":"string"}},"history":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer"},"event":{"type":"string"}}}}}},"name_change_history":{"type":"object","description":"商号・所在地の変更履歴（国税庁）","required":["available","source","source_url","observed_at","missing_reason","items"],"properties":{"available":{"type":"boolean","description":"中身があるか"},"source":{"type":["string","null"]},"source_url":{"type":["string","null"]},"observed_at":{"type":["string","null"]},"missing_reason":{"type":["string","null"],"description":"available が false のときの理由"},"items":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["company_name","prefecture","city"]},"from":{"type":["string","null"]},"to":{"type":["string","null"]},"date":{"type":"string"}}}}}},"attribution":{"type":"object","required":["notice_ja","required_statements_ja"],"properties":{"notice_ja":{"type":"string"},"required_statements_ja":{"type":"array","items":{"type":"string"}}}},"notes_ja":{"type":"array","items":{"type":"string"}}}},"BalanceResponse":{"type":"object","required":["balance_jpy","price_per_company_jpy","free_remaining_this_month","topup_url"],"properties":{"balance_jpy":{"type":"integer"},"price_per_company_jpy":{"const":50},"free_remaining_this_month":{"type":"integer"},"free_quota_per_month":{"type":"integer"},"free_resets_on":{"type":"string"},"deposits":{"type":"array","items":{"type":"object","properties":{"remaining_jpy":{"type":"integer"},"expires_at":{"type":"string"}}}},"topup_url":{"type":"string"},"docs_url":{"type":"string"},"note_ja":{"type":"string"}}}}}}