> ## 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.

# Using the Public API

> We provide a public API so you can freely use the data you collect.

We provide a public API so you can freely use the data you collect.

For details on the available Public API endpoints, see the [documentation](/en/api-reference/it-management).

You can also open it from **Settings** > **API Key List** by clicking "API Documentation".

<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 documentation screen" width="2574" height="478" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-38-12.png" />

<h2 id="organization-id">
  Finding your Organization ID
</h2>

Your **Organization ID** is shown as **Organization ID** under **Settings** > **API Key List**. Copy it for use in API calls.

<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="Organization ID screen" width="1298" height="312" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-46-13.png" />

## Setting the Organization ID in the Public API

When setting Path Params > **organizationId** in the Public API, enter the value you copied [above](#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 setting screen" width="1244" height="180" data-path="images/it-management/cw1ivgng0g/2025-09-03-13-11-12.png" />

<h2 id="generate-api-key">
  Generating an API Key
</h2>

1. Go to Settings > API Key List and click the **Generate API Key** button.

2. On the "Generate API Key" screen, enter a name for the API key and click **Generate**.

   <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 key generation screen" width="732" height="454" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-52-59.png" />

3. An API key is issued. Copy and save it.
   Note: You need this key to call the Public API. It is shown only once, so keep it somewhere safe.

<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 key copy screen" width="2554" height="812" data-path="images/it-management/cw1ivgng0g/2025-09-03-8-48-51.png" />

## Setting the API Key in the Public API

When setting Credentials > Bearer in the Public API, enter the value you copied [above](#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 setting screen" width="900" height="158" data-path="images/it-management/cw1ivgng0g/2025-09-03-13-17-02.png" />

## Finding a Service ID

"serviceId": Go to Services > the target SaaS (e.g. GitHub) > Service 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="Service ID screen" width="696" height="432" data-path="images/it-management/cw1ivgng0g/2026-07-09-9-09-00.png" />

## When the Public API returns an error

If you see an error while using the Public API, contact Support with the following information.

For how to contact support, see [Contacting Support](/en/it-management/changelog/3e6sz4xzsx-support).

* The name or URL of the Public API you are using
* Details of the error

## FAQ

### Q. Can I switch the API to Japanese?

A. The UI does not support language switching. Use your browser's language settings to view the page in a different language.

<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="Language switching screen" width="572" height="246" data-path="images/it-management/cw1ivgng0g/2025-11-07-9-31-08.png" />

### Q. Are there rules for the "Field ID Name" in API custom fields?

A. Custom field names may only use `lowercase alphanumeric characters and _ (underscore)`.

For details on configuring custom fields, see the [Device](/en/it-management/device/2gdbiob664-device-itme#add-a-custom-field) and [Directory](/en/it-management/directory/gqqdb2621q-edit-uid#add-custom-fields) help pages.

### Q. Can I specify a registration time with the API?

A. Yes. The API accepts the `createdAt` parameter, which lets you specify the **date**, **hour**, and **minute**.

### Q. The timestamps in data retrieved via the API do not match what is shown in the admin panel. Why?

A. The Public API returns all timestamps in UTC (Coordinated Universal Time). The admin panel displays times in your local timezone (e.g. Japan Standard Time / JST). The API uses UTC to ensure reliable integration between systems.

### Q. How do I convert API timestamps to Japan Standard Time (JST)?

A. Convert the timestamp from UTC to your local timezone on your end. All date strings sent and received by the API are interpreted as UTC. For example, Japan Standard Time (JST) is 9 hours ahead of UTC, so `00:00:00Z` in the API corresponds to `09:00:00` in JST.

### Q. How should I specify the timezone when sending data (POST/PATCH) via the API?

A. Always send timestamps in UTC. The Public API interprets all incoming date strings as UTC and stores them as such. If you send a local time without converting it first, the data may be stored with an unintended timestamp. Convert to UTC before sending.
