高速レスポンス
平均レスポンス時間 < 100ms の高速処理
99.9% SLA
高い可用性とサービス品質を保証
セキュア
SOC2 認証取得済みの高セキュリティ
クイックスタート
3つのステップで API を使い始められます
1
2
リクエストを送信
法人番号を指定してAPIリクエストを送信します。
3
法人情報を取得
JSON形式で法人情報を受け取ります。
サンプルリクエスト
curl -X GET \
"https://api.ichisan.jp/v1/corporate/1234567890123" \
-H "Authorization: Bearer YOUR_API_KEY"
レスポンス例
{
"corporateNumber": "1234567890123",
"name": "株式会社サンプル",
"nameKana": "カブシキガイシャサンプル",
"address": "東京都渋谷区神宮前1-2-3",
"representative": "山田太郎",
"establishmentDate": "2020-01-01",
"status": "active"
}
エンドポイント一覧
法人情報取得に関する各種エンドポイント
GET
/v1/corporate/{corporateNumber}法人情報取得
法人番号を指定して、法人の基本情報を取得します。
パラメータ
corporateNumber必須13桁の法人番号
レスポンスフィールド
corporateNumber法人番号name法人名nameKana法人名（カナ）address所在地representative代表者名establishmentDate設立年月日statusステータスGET
/v1/corporate/search法人検索
法人名や住所で法人を検索します。部分一致検索に対応しています。
クエリパラメータ
name任意法人名（部分一致）
address任意住所（部分一致）
limit任意取得件数（最大100件）
使用例
GET /v1/corporate/search?name=株式会社&limit=10
POST
/v1/corporate/bulkバルク取得
複数の法人番号を一度に送信して、まとめて法人情報を取得します。
リクエストボディ
{
"corporateNumbers": [
"1234567890123",
"9876543210987"
]
}
制限事項
- • 最大100件まで一度に処理可能
- • レスポンス時間は件数に比例
- • エラーの法人番号もレスポンスに含まれます
認証
API キーを使用したBearer認証
APIキーの使用方法
1. HTTPヘッダーに追加
Authorization: Bearer YOUR_API_KEY
2. 全てのリクエストに必須
すべてのAPIエンドポイントにアクセスする際、Authorizationヘッダーが必要です。
3. セキュリティ
- • APIキーは秘匿情報として管理してください
- • HTTPS通信でのみ使用してください
- • 定期的なキーローテーションを推奨します
- • クライアントサイドでの使用は避けてください
エラーコード
API で返却される HTTP ステータスコード
200
OK
リクエスト成功
400
Bad Request
リクエストパラメータエラー
401
Unauthorized
認証エラー（APIキー無効）
403
Forbidden
アクセス権限なし
404
Not Found
法人番号が見つからない
429
Too Many Requests
レート制限に達した
500
Internal Server Error
サーバー内部エラー
503
Service Unavailable
サービス一時停止中
SDK & サンプルコード
各言語でのサンプルコードをご用意しています
JavaScript
const response = await fetch(
'https://api.ichisan.jp/v1/corporate/1234567890123',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);Python
import requests
url = "https://api.ichisan.jp/v1/corporate/1234567890123"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
data = response.json()
print(data)PHP
$url = 'https://api.ichisan.jp/v1/corporate/1234567890123';
$headers = [
'Authorization: Bearer YOUR_API_KEY'
];
$context = stream_context_create([
'http' => ['header' => implode("\r\n", $headers)]
]);
$response = file_get_contents($url, false, $context);
$data = json_decode($response, true);Ruby
require 'net/http'
require 'json'
uri = URI('https://api.ichisan.jp/v1/corporate/1234567890123')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = http.request(request)
data = JSON.parse(response.body)