# 登記くん ドキュメント

> 商業登記簿API「登記くん」は、企業調査のための登記簿取得を自動化できるサービスです。API経由で登記簿情報を取得し、取引先審査業務の効率化を実現します。

## 100件プランご登録方法

このページでは、[ポータルサイト](https://portal.tychy.jp/)にサインアップして、100件プランにご登録頂く方法について説明します。

### サインアップとログイン

[ポータルサイト](https://portal.tychy.jp/)にアクセスし、右上の「会員登録」を押してください。

![トップページ](/img/100plan_toppage.png)

「氏名」「会社・組織名」「メールアドレス」を入力いただき、利用規約とプライバシーポリシーをご確認の上「登録」ボタンを押してください。

![Sign Up](/img/100plan_signup.png)

正常にアカウントの登録が完了するとメールが送信されます。

![Welcome](/img/100plan_welcome.png)

次に、「Login」を押しメールアドレスを入力してください。

![Login](/img/100plan_login.png)

認証コードがメールで送信されますので、入力してください。

![Verify](/img/100plan_verify.png)

ポータルサイトへログインが完了している状態であることを確認してください。

![Portal](/img/100plan_portal.png)

### 100件プランへの登録

100件プランのご利用を希望される場合、「支払い」タブへ遷移して「登録する」ボタンを押してください。

![Payment](/img/100plan_payment.png)

お支払情報を入力いただき、「申し込みボタン」を押してください。

![Stripe](/img/100plan_stripe.png)

再度ログインいただくと、プランが更新されていることをご確認いただけます。

![After Pay](/img/100plan_afterpay.png)

「APIキー」タブからAPIをご確認いただき、ご利用が開始できます。

![Apikey](/img/100plan_apikey.png)


import { Callout } from 'vocs/components'

## API仕様

このページでは、商業登記簿API「登記くん」の仕様を説明します。

### HTTPステータスコード

| ステータスコード | RPC                               | 説明                                                                                                               |
| -------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| 200      | OK                                | 処理が正常に完了しました。                                                                                                    |
| 202      | Accepted                          | 登記簿取得を他のリクエストで処理中です。                                                                                             |
| 400      | BadRequest                        | 不正なパラメーターです。                                                                                                     |
| 401      | Unauthorized                      | APIキーが正しくありません。                                                                                                  |
| 402      | Payment Required                  | トライアル期間を過ぎているか、精算に失敗しています。                                                                                       |
| 403      | Forbidden                         | 実行できないAPIが指定されました。                                                                                               |
| 404      | Not Found                         | 入力された法人番号に対応する結果が存在しません。                                                                                         |
| 429      | Too Many Requests                 | APIリクエスト量が制限されました。                                                                                               |
| 500      | Internal Server Error             | システムに異常が発生しました。お手数ですが[support@tychy.jp](mailto\:support@tychy.jp)までお問い合わせください。                                   |
| 503      | Service Unavailable               | サービスが一時的に利用できません。                                                                                                |
| 504      | Gateway Timeout                   | タイムアウトしました。リトライしてください。                                                                                           |
| 512      | Teikyo Site Outside Business Hour | 登記簿提供サイトの営業時間外です。                                                                                                |
| 513      | Teikyo Site Temporary Unavailable | 登記簿提供サイトが一時的に利用できませんでした。                                                                                         |
| 514      | Touki Jiken                       | 請求のあった会社・法人等は登記事件の処理中です。                                                                                         |
| 515      | Exceeds Plan Limit                | プランの上限を超えています。                                                                                                   |
| 516      | AccountNotActive                  | アカウントが無効です。                                                                                                      |
| 517      | Large Touki Not Supported         | 大規模登記簿は現在サポートされていません。登記簿のデータ量が多く、分割請求が必要な法人は対応しておりません。詳細は [FAQ](/faq#517エラー-large-touki-not-supported) をご確認ください。 |

### GET /v1/toukikun/:houjinNumber

与えられた法人番号を元に、登記簿PDFを取得します。PDFをS3にアップロードし、URLと登記簿の解析結果を返します。

<Callout type="info">
  登記簿請求には30秒以上かかる場合があります。最初のリクエストがタイムアウトした場合にも非同期で実行を完了し、結果をキャッシュしています。3分後に再度リクエストしてください。3日以内の同じ法人番号に対するリクエストには一度しか課金されません。
</Callout>

#### リソースURL

```
https://api.tychy.jp/v1/toukikun/:houjinNumber
```

#### 呼び出し例

13桁の法人番号を設定してください。

```bash
curl -X GET https://api.tychy.jp/v1/toukikun/1234567890123 -H "Authorization: Bearer <APIキー>"
```

#### パラメーター

| パラメーター       | 型      | 説明                                    | 例               |
| ------------ | ------ | ------------------------------------- | --------------- |
| houjinNumber | string | 登記簿を取得したい法人の法人番号。ハイフンなしの13桁で指定してください。 | "1234567890123" |

#### レスポンス

| パラメーター                        | 型         | 説明                   | 補足                                                                 |
| ----------------------------- | --------- | -------------------- | ------------------------------------------------------------------ |
| request\_id                   | string    | リクエストを一意に特定するためのUUID |                                                                    |
| message                       | string    | システムからのメッセージ         | 　お問い合わせの際にご添付ください                                                  |
| is\_charged                   | bool      | 課金されたか               |                                                                    |
| published\_at                 | timestamp | API呼び出し時刻            |                                                                    |
| cache\_expires\_at            | timestamp | キャッシュ有効期限(課金から3日以内)  |                                                                    |
| signed\_url                   | string    | 登記簿PDFのリンク           |                                                                    |
| pdf\_name                     | string    | PDFファイル名             |                                                                    |
| file\_id                      | string    | ファイルID               |                                                                    |
| houjin\_number                | string    | 法人番号                 |                                                                    |
| toukibo\_created\_at          | timestamp | 登記簿発行時刻              |                                                                    |
| houjin\_name                  | string    | 法人名                  |                                                                    |
| houjin\_kaku                  | string    | 法人格                  | "株式会社"など、現在対応している法人格の一覧は[こちら](/faq#対応している法人格の一覧)                   |
| houjin\_address               | string    | 法人住所                 |                                                                    |
| houjin\_capital               | int       | 資本金                  |                                                                    |
| houjin\_stock                 | int       | 発行済み株式数              |                                                                    |
| houjin\_preferred\_stocks     | \[]object | 優先株式の情報              | 各優先株式の種類(preferred\_stock\_type)と数量(preferred\_stock\_amount)を含む配列 |
| houjin\_executive\_names      | \[]string | （現在有効な）役員氏名          |                                                                    |
| houjin\_representative\_names | \[]string | （現在有効な）代表者氏名         |                                                                    |
| houjin\_created\_at           | string    | 法人設立年月日              |                                                                    |
| houjin\_bankrupted\_at        | string    | 法人破産年月日              |                                                                    |
| houjin\_dissolved\_at         | string    | 法人解散年月日              |                                                                    |
| houjin\_continued\_at         | string    | 法人継続年月日              |                                                                    |

##### レスポンスの例

```json
{
  "request_id": "018ecc69-d3b7-7ec9-8da8-e9a440300e2c",
  "message": "[free] toukibo found in cache",
  "is_charged": false,
  "published_at": "2024-03-10T13:31:44.187994546+09:00",
  "cache_expires_at": "2024-03-13T07:09:58.724351+09:00",
  "signed_url": "https://xxxx",
  "pdf_name": "0123012301234_20240309220958.pdf",
  "file_id": "779243783f72659fe3b6",
  "houjin_number": "0123012301234",
  "toukibo_created_at": "2024-03-10T13:31:44Z",
  "houjin_name": "株式会社近畿商事",
  "houjin_kaku": "株式会社",
  "houjin_address": "東京都Sample区Sample１丁目１番地１",
  "houjin_capital": 200000000,
  "houjin_stock": 20000,
  "houjin_preferred_stocks": [
    {
      "preferred_stock_type": "普通株式",
      "preferred_stock_amount": 10000
    },
    {
      "preferred_stock_type": "A1種優先株式",
      "preferred_stock_amount": 5000
    },
    {
      "preferred_stock_type": "A2種優先株式",
      "preferred_stock_amount": 5000
    }
  ],
  "houjin_executive_names": [
    "里井達也",
    "壹岐正"
  ],
  "houjin_representative_names": [
    "壹岐正"
  ],
  "houjin_created_at": "令和2年4月1日",
  "houjin_bankrupted_at": "",
  "houjin_dissolved_at": "",
  "houjin_continued_at": ""
}
```

### GET /v1/getpdf/:id

与えられたファイルIDから、登記簿PDFを取得します。

#### リソースURL

```
https://api.tychy.jp/v1/getpdf/:id
```

#### 呼び出し例

ファイルIDには/v1/toukikunのレスポンスから取得したファイルIDを設定してください。

```bash
curl -X GET https://api.tychy.jp/v1/getpdf/jc1e0f1c9798cXXXXXXX -H "Authorization: Bearer <APIキー>"
```

#### パラメーター

| パラメーター | 型    | 説明                                                          | 例                                      |
| ------ | ---- | ----------------------------------------------------------- | -------------------------------------- |
| id     | uuid | `GET /v1/toukikun/:houjinNumber`のレスポンスに含まれるファイルIDを指定してください。 | "1b826e33-44fe-420a-b20c-b3bb6937aa2c" |

#### レスポンス

Content-Type:"application/json"で、pdfObject.BodyにPDF本文が格納されます。

<Callout type="info">
  ファイル保存期間は1年間です。保持期間内であってもライセンス契約が終了した場合には、ファイルは削除される可能性があります。
</Callout>

### GET /v1/ping

疎通確認用です。APIキーが正しく設定されているかを確認するために利用してください。

呼び出し例

```bash
curl -X GET https://api.tychy.jp/v1/ping -H "Authorization: Bearer <APIキー>"
```

### GET /v1/todayusage

当日の課金対象となった登記簿取得件数を返します。[^1]

呼び出し例（50件取得した場合）

```bash
curl -X GET https://api.tychy.jp/v1/todayusage -H "Authorization: Bearer <APIキー>"
# → 50
```

### GET /v1/currentmonthusage

当月の課金対象となった登記簿取得件数を返します。[^1]

呼び出し例（50件取得した場合）

```bash
curl -X GET https://api.tychy.jp/v1/currentmonthusage -H "Authorization: Bearer <APIキー>"
# → 50
```

### GET /v1/previousmonthusage

先月の課金対象となった登記簿取得件数を返します。[^1]

呼び出し例（50件取得した場合）

```bash
curl -X GET https://api.tychy.jp/v1/previousmonthusage -H "Authorization: Bearer <APIキー>"
# → 50
```

[^1]: 課金対象でないリクエスト（エラーになった登記簿取得や、3日以内にキャッシュから取得した登記簿取得）は対象となりません。


## よくあるご質問

### エラーコードとトラブルシューティング

#### 517エラー: Large Touki Not Supported

一部の大規模法人（例：楽天グループ株式会社（法人番号9010701020592）など）では、登記簿のデータ量が非常に多く、登記簿提供サービス側で分割請求が必要となります。現在、登記くんAPIではこの分割請求方式に対応しておりません。

![情報量オーバーエラー](/img/too_large.png)

### 対応している法人格の一覧

2025年11月7日（[v1.0.38](https://github.com/tychy/toukibo-parser/tree/v1.0.38)）時点で以下の法人格に対応しています。

* 株式会社
* 有限会社
* 合同会社
* 合資会社
* 合名会社
* 特定目的会社
* 協同組合
* 労働組合
* 森林組合
* 生活衛生同業組合
* 信用金庫
* 商工会
* 公益財団法人
* 農事組合
* 宗教法人
* 管理組合法人
* 医療法人
* 司法書士法人
* 税理士法人
* 社会福祉法人
* 一般社団法人
* 公益社団法人
* 一般財団法人
* NPO法人
* 特定非営利活動法人
* 政党
* 国立大学法人
* 弁護士法人
* 独立行政法人
* 学校法人
* 認可法人
* 特殊法人
* 特別民間法人


## 商業登記簿API「登記くん」のご利用例

あくまでもこの手順は参考情報として提供されるものであり、その正確性、完全性、有用性等について一切の保証を行うものではありません。

* Slack Botから商業登記簿取得
  * [こちらの記事](https://zenn.dev/tychy/articles/5fd61b9dddf7ee)をご参照ください
* ベースマキナからの商業登記簿取得
  * [こちらの記事](https://zenn.dev/tychy/articles/3dca6878b7060a)をご参照ください
* GASからの商業登記簿取得
  * [こちらの記事](https://zenn.dev/tychy/articles/771f186af9ae7c)をご参照ください


import { Callout } from 'vocs/components'

## 料金

このページでは、商業登記簿API「登記くん」の料金について説明します。

商業登記簿API「登記くん」の利用にはライセンスの月額利用料と、ご利用件数に応じた登記簿取得費用が必要です。

### ライセンスの月額利用料

#### 本番環境用ライセンス

| 月間登記簿取得上限 | ライセンス料金(1ヶ月) | ご請求方法    | 注意          |
| --------- | ------------ | -------- | ----------- |
| 100件      | 50,000円 + 税  | クレジットカード | 登記簿代含む,固定料金 |
| 500件      | 150,000円 + 税 | クレジットカード | 登記簿代除く      |
| 2000件     | 300,000円 + 税 | クレジットカード | 登記簿代除く      |

<Callout type="info">
  月の途中から契約を開始した場合でも、1ヶ月分の料金が発生します。

  月100件プランのみ、登記簿代が固定料金に含まれています。
</Callout>

#### 開発環境用ライセンス

登記簿取得料金を気にせずご利用いただける開発環境も用意しております。入力された法人番号に合わせてあらかじめ決められた登記簿ファイルを返します。

本番環境用ライセンスをご契約いただいていれば、無料でAPIキーを発行いたします。[support@tychy.jp](mailto\:support@tychy.jp)までご依頼ください。

### 登記簿取得費用

登記簿1件あたり**税込331円**です。法務局と同じ値段で提供しています。

<Callout type="info">
  登記簿取得代金は翌月のライセンス料金と合わせてご請求いたします。
</Callout>

### お問い合わせ

製品へのお問い合わせは [support@tychy.jp](mailto\:support@tychy.jp) までお願い致します。


## リリースノート

### 2025/12/06

* パッケージを更新

### 2025/11/08

* 登記簿パーサーを[v1.0.39](https://github.com/tychy/toukibo-parser/releases/tag/v1.0.39)に更新

### 2025/06/07

* 登記簿パーサーを[v1.0.38](https://github.com/tychy/toukibo-parser/releases/tag/v1.0.38)に更新

### 2025/05/01

* レスポンスに優先株式（houjin\_preferred\_stocks）を追加

### 2025/04/28

* 登記簿パーサーを[v1.0.36](https://github.com/tychy/toukibo-parser/tree/v1.0.36)に更新

### 2025/04/20

* 登記簿パーサーを[v1.0.35](https://github.com/tychy/toukibo-parser/tree/v1.0.35)に更新

### 2025/03/30

* 登記簿パーサーを[v1.0.34](https://github.com/tychy/toukibo-parser/tree/v1.0.34)に更新

### 2025/03/20

* 登記簿パーサーを[v1.0.33](https://github.com/tychy/toukibo-parser/tree/v1.0.33)に更新

### 2025/03/10

* 複数の軽微な修正を実施

### 2025/01/02

* 登記簿パーサーを[v1.0.32](https://github.com/tychy/toukibo-parser/tree/v1.0.32)に更新

### 2024/12/30

* 登記簿パーサーを[v1.0.31](https://github.com/tychy/toukibo-parser/tree/v1.0.31)に更新しカブアンド種類株式に対応

### 2024/12/26

* 登記簿パーサーを[v1.0.30](https://github.com/tychy/toukibo-parser/tree/v1.0.30)に更新し公益社団法人と「橋」の異体字に対応

### 2024/12/17

* ロードバランサーをVultr Node BalancerからNginxに変更し、クラスターにオンプレミスのサーバーを追加

### 2024/11/11

* 登記簿パーサーを[v1.0.29](https://github.com/tychy/toukibo-parser/tree/v1.0.29)に更新し「邦」「楢」の異体字に対応

### 2024/09/28

* 登記簿パーサーを[v1.0.28](https://github.com/tychy/toukibo-parser/tree/v1.0.28)に更新し弁護士法人に対応

### 2024/09/11

* 登記簿パーサーを[v1.0.25](https://github.com/tychy/toukibo-parser/tree/v1.0.25)に更新し発行済み株式数に対応

### 2024/09/09

* 登記簿パーサーを[v1.0.24](https://github.com/tychy/toukibo-parser/tree/v1.0.24)に更新し「藤」「荒」の異体字に対応
* 債務超過額が登記されている場合の資本金の解析を改善

### 2024/09/02

* 登記簿パーサーを[v1.0.23](https://github.com/tychy/toukibo-parser/tree/v1.0.23)に更新し「角」の異体字に対応

### 2024/08/26

* 登記簿パーサーを[v1.0.22](https://github.com/tychy/toukibo-parser/tree/v1.0.22)に更新し破産管財人と保全管財人に対応

### 2024/08/19

* 登記簿パーサーを[v1.0.21](https://github.com/tychy/toukibo-parser/tree/v1.0.21)に更新し資本金に関する解析を改善

### 2024/08/05

* 登記簿パーサーを[v1.0.20](https://github.com/tychy/toukibo-parser/tree/v1.0.20)に更新し政党と国立大学法人に対応

### 2024/07/16

* 登記簿パーサーを[v1.0.19](https://github.com/tychy/toukibo-parser/tree/v1.0.19)に更新し職務執行者に対応

### 2024/07/12

* /v1/currentmonthusage ,/v1/previousmonthusageを公開し、お客様の登記簿取得件数をAPI経由で参照いただけるようになりました。

### 2024/07/09

* 登記簿パーサーを[v1.0.18](https://github.com/tychy/toukibo-parser/releases/tag/v1.0.18)に更新し、代表執行役に対応

### 2024/07/01

* 登記簿パーサーを[v1.0.17](https://github.com/tychy/toukibo-parser/releases/tag/v1.0.17)に更新し、役員をレスポンスに追加
* [商業登記簿解析ツール](https://toukibo-parser-demo.tychy.jp/)を公開しました
* レスポンスに役員名(HoujinExecutiveNames)と会社継続(HoujinContinuedAt)を追加しました

### 2024/06/17

* 登記簿パーサーをv1.0.16に更新し、合同会社の解析を改善

### 2024/06/09

* 登記簿パーサーをv1.0.15に更新し、常用漢字への変換を追加

### 2024/06/03

* 登記簿パーサーをv1.0.14に更新し、学長に対応

### 2024/05/19

* 登記簿パーサーをv1.0.13に更新し、会社継続へ対応

### 2024/05/04

* 登記簿パーサーをv1.0.12に更新し、解散登記のパースを改善

### 2024/05/02

* 登記簿パーサーをv1.0.10に更新し、那覇に対応

### 2024/04/21

* 登記簿パーサーをv1.0.9に更新

### 2024/03/11

* 登記簿パーサーをv1.0.8に更新し、破産/解散情報に対応しました
* [ポータルサイト](https://portal.tychy.jp/)の提供を開始いたしました

### 2023/10/21

* [登記簿パーサー](https://github.com/tychy/toukibo_parser)を登記くんに組み込み、登記簿情報の解析機能を追加しました
* テスト環境の提供を開始しました

### 2023/07/01

* 初期リリースを行いました