> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Public APIを使用する

> 取得したデータを自由に活用できるようPublic APIを公開しています。

取得したデータを自由に活用できるようPublic APIを公開しています。

提供しているPublic APIの詳細は[ドキュメント](/api-reference/it-management)をご参照ください。

**設定** > **APIキー一覧**の「APIドキュメント」からもご確認いただけます。

<img src="https://mintcdn.com/moneyforwardi/0FfE6EsyXirDkNvw/images/it-management/cw1ivgng0g/2025-09-03-8-38-12.png?fit=max&auto=format&n=0FfE6EsyXirDkNvw&q=85&s=b94510c73665af00b734ff032f5d74fc" alt="APIドキュメント画面" width="2574" height="478" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-38-12.png" />

<h2 id="organization-id">
  OrganizationIDの確認
</h2>

**設定** > **APIキー一覧**の **組織ID** が**OrganizationID**となりますのでコピーしておきます。

<img src="https://mintcdn.com/moneyforwardi/0FfE6EsyXirDkNvw/images/it-management/cw1ivgng0g/2025-09-03-8-46-13.png?fit=max&auto=format&n=0FfE6EsyXirDkNvw&q=85&s=53e09b3c12136cce8aae2a49fe1ebd32" alt="OrganizationID確認画面" width="1298" height="312" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-46-13.png" />

## Public APIでOrganizationIDを設定する

Public APIでPath Params > **organizationId**を設定する場合、[上記](#organization-id)でコピーした値を入力します。

<img src="https://mintcdn.com/moneyforwardi/0FfE6EsyXirDkNvw/images/it-management/cw1ivgng0g/2025-09-03-13-11-12.png?fit=max&auto=format&n=0FfE6EsyXirDkNvw&q=85&s=349139ceebb88e8d37e22b9543035973" alt="organizationId設定画面" width="1244" height="180" data-path="images/it-management/cw1ivgng0g/2025-09-03-13-11-12.png" />

<h2 id="generate-api-key">
  APIキーの発行
</h2>

1. 設定 > APIキー一覧　から、\[**APIキーを生成する**]ボタンをクリックします。

2. 「APIキーの生成」画面でAPIキー名に任意の名前を入力し、［生成する］をクリックします。

   <img src="https://mintcdn.com/moneyforwardi/0FfE6EsyXirDkNvw/images/it-management/cw1ivgng0g/2025-09-03-8-52-59.png?fit=max&auto=format&n=0FfE6EsyXirDkNvw&q=85&s=e839bb549e580c36d192b3b6f06c1c54" alt="APIキー生成画面" width="732" height="454" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-52-59.png" />

3. APIキーが発行されますので、コピーして保存します。
   ※Public APIを実行するために必要です。一度しか表示されませんので、ご注意ください。

<img src="https://mintcdn.com/moneyforwardi/0FfE6EsyXirDkNvw/images/it-management/cw1ivgng0g/2025-09-03-8-48-51.png?fit=max&auto=format&n=0FfE6EsyXirDkNvw&q=85&s=77cc72b7f6a33cfc7c94b8aa43c6918e" alt="APIキーコピー画面" width="2554" height="812" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-48-51.png" />

## Public APIでAPIキーを設定する

Public APIでCredentials > Bearerを設定する場合、[上記](#generate-api-key)でコピーした値を入力します。

<img src="https://mintcdn.com/moneyforwardi/0FfE6EsyXirDkNvw/images/it-management/cw1ivgng0g/2025-09-03-13-17-02.png?fit=max&auto=format&n=0FfE6EsyXirDkNvw&q=85&s=f74c7738f1f51a6e7e1142cd788dfb74" alt="Bearer設定画面" width="900" height="158" data-path="images/it-management/cw1ivgng0g/2025-09-03-13-17-02.png" />

## サービスIDを確認する

"serviceId"：サービス > 対象のSaaS（Githubなど）> サービス ID から確認できます。

<img src="https://mintcdn.com/moneyforwardi/abaHWZT0tTzI_Qae/images/it-management/cw1ivgng0g/2026-07-09-9-09-00.png?fit=max&auto=format&n=abaHWZT0tTzI_Qae&q=85&s=28b23dfe4b89e867661fd5dc045f188a" alt="サービスID確認画面" width="696" height="432" data-path="images/it-management/cw1ivgng0g/2026-07-09-9-09-00.png" />

## Public APIでエラーが表示される場合

Public APIをご利用中にエラーが表示される場合、以下を記載の上、サポートにお問い合わせください。

お問い合わせ方法は[サポートへのお問い合わせ](/it-management/changelog/3e6sz4xzsx-support)もご参照ください。

* ご利用のPublic APIの名称またはURL
* エラー詳細をご記載ください。

## FAQ

### Q. APIは日本語に切り替えできないのでしょうか？

A. UI上では言語の切り替えに対応しておりませんので、ブラウザ側の言語切り替えでご確認をお願いします。

<img src="https://mintcdn.com/moneyforwardi/0FfE6EsyXirDkNvw/images/it-management/cw1ivgng0g/2025-11-07-9-31-08.png?fit=max&auto=format&n=0FfE6EsyXirDkNvw&q=85&s=0b1096bd05c7e3b753549deb773c44c0" alt="言語切り替え画面" width="572" height="246" data-path="images/it-management/cw1ivgng0g/2025-11-07-9-31-08.png" />

### Q. APIのカスタム項目での「Field ID Name」の設定・編集のルールはありますか？

A. カスタム項目の入力項目名には`小文字の英数字と_（アンダースコア）`のみ使用可能です。

カスタム項目の設定については、[デバイス](/it-management/device/2gdbiob664-device-itme#カスタム項目を追加する)と[ディレクトリ](/it-management/directory/gqqdb2621q-edit-uid#add-custom-fields)の各ヘルプページもご参照ください。

### Q. APIで登録時間を指定する事はできますか？

A. APIでは、 `createdAt` パラメータで**日付**、**時**、**分**を指定できます。

### Q. APIで取得したデータの時刻が、管理画面の表示と一致しません。なぜですか？

A. Public APIでは、すべてのタイムスタンプを「UTC（協定世界時）」で統一しているためです。管理画面（UI）では、ローカルタイムゾーン（例：日本標準時/JST）で時刻を表示しています。一方で、APIはシステム間の連携を確実にするため、世界共通の基準であるUTCを使用します。

### Q. APIから取得した時刻を日本時間（JST）に直すにはどうすればよいですか？

A. お客様側で、UTCからローカルタイムゾーンへの変換処理をお願いします。APIから送受信される日付文字列は、すべてUTCとして解釈されます。例えば、日本時間（JST）はUTCより9時間進んでいるため、APIで `00:00:00Z` となっている場合は、日本時間では `09:00:00` となります。

### Q. APIでデータを送信（POST/PATCH）する際、タイムゾーンはどう指定すべきですか？

A. 常にUTCとして送信してください。Public APIは、送られてきた日付文字列を常にUTCとして解釈し、システムに保存します。ローカル時間をそのまま送信すると、意図しない時刻で登録される可能性があるため、必ず変換してから送信してください。