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

# Account information API

> HubSpot's account information API endpoints provide account configuration and usage data.

export const BetaDisclaimerBanner = () => <Warning>
        This functionality is currently in beta. By participating in this beta, you agree to HubSpot's <a href="https://legal.hubspot.com/developer-terms">Developer Terms</a> and <a href="https://legal.hubspot.com/developerbetaterms">Developer Beta Terms</a>. Note that the functionality is still under active development and is subject to change based on testing and feedback.
    </Warning>;

The following endpoints provide information about a given HubSpot account, including the account settings, and API usage details for [developer platform apps](/docs/apps/developer-platform/build-apps/create-an-app), integrations using [service keys](/docs/apps/developer-platform/build-apps/authentication/account-service-keys), and [legacy private apps](/docs/apps/legacy-apps/private-apps/overview).

## Get account details for a HubSpot account

To retrieve details for a standard HubSpot account, make a `GET` request to `/account-info/2027-03-beta/details`. The response will resemble the following:

```json theme={null}
{
  "portalId": 123456,
  "portalName": "My developer account",
  "accountType": "STANDARD",
  "timeZone": "US/Eastern",
  "companyCurrency": "USD",
  "additionalCurrencies": [
    "EUR"
  ],
  "utcOffset": "-05:00",
  "utcOffsetMilliseconds": -18000000,
  "uiDomain": "app.hubspot.com",
  "dataHostingLocation": "na1"
}
```

A full list of properties is provided in the table below:

| Property | Type | Description |
| - | - | - |
| `portalId` | Number | The ID of the HubSpot account, sometimes referred to as the account's [Hub ID](https://knowledge.hubspot.com/account-management/manage-multiple-hubspot-accounts#check-your-current-account). |
| `portalName` | String | The [configured name](https://knowledge.hubspot.com/account-management/update-your-account-name-and-company-information#customize-your-account-name) of the HubSpot account. |
| `accountType` | String | An enumeration corresponding to the [account type](/docs/getting-started/account-types): <ul><li>`STANDARD`: a [standard HubSpot account](/docs/getting-started/account-types#standard-hubspot-accounts).</li><li>`DEVELOPER_TEST`: a [developer test account](/docs/getting-started/account-types#developer-test-accounts).</li><li>`SANDBOX`: a [sandbox](/docs/getting-started/account-types#sandbox-accounts) account.</li><li>`APP_DEVELOPER`: a [legacy developer account](/docs/getting-started/account-types#developer-accounts).</li></ul> |
| `timeZone` | String | The name of the account's [configured timezone](https://knowledge.hubspot.com/account-management/change-your-language-and-region-settings#customize-your-account-time-zone) (e.g., `"US/Eastern"`). |
| `companyCurrency` | String | The currency code of the account's [configured currency](https://knowledge.hubspot.com/account-management/add-and-edit-your-account-currencies). |
| `additionalCurrencies` | Array | An array of [additional](https://knowledge.hubspot.com/account-management/add-and-edit-your-account-currencies#configure-new-currencies) configured currencies. Note that a *Starter* account or higher is required to add more than one account currency. |
| `utcOffset` | String | The difference in hours between the account's timezone and Coordinated Universal Time (UTC). |
| `utcOffsetMilliseconds` | Number | The difference in milliseconds between the account's timezone and Coordinated Universal Time (UTC). |
| `uiDomain` | String | The domain used to log in to the main HubSpot user interface. |
| `dataHostingLocation` | String | The location of the data center where your account is hosted (e.g., `"eu1"` or `"na1"`). |

## Check daily API usage and limits for apps in your account

The daily API usage endpoint can be used to check the aggregate API calls that all apps have made for the current day, which includes [developer platform apps](/docs/apps/developer-platform/build-apps/create-an-app), integrations using [service keys](/docs/apps/developer-platform/build-apps/authentication/account-service-keys), and [legacy private apps](/docs/apps/legacy-apps/private-apps/overview).

The current day is measured from midnight to midnight based on the connected account's time zone settings. Read more about HubSpot's [API usage guidelines](/docs/developer-tooling/platform/usage-guidelines).

To retrieve usage and limit data for your apps, make a `GET` request to `/account-info/2027-03-beta/api-usage/daily/private-apps`.

The response will resemble the following:

```json theme={null}
{
  "results": [
    {
      "name": "private-apps-api-calls-daily",
      "usageLimit": 1000000,
      "currentUsage": 2,
      "collectedAt": "2025-12-12T22:25:10.655Z",
      "fetchStatus": "SUCCESS",
      "resetsAt": "2025-12-13T05:00:00Z",
      "usageByAppType": [
        {
          "appType": "LEGACY_PRIVATE_APP",
          "currentUsage": 1
        },
        {
          "appType": "DEVELOPER_PLATFORM_APP",
          "currentUsage": 0
        },
        {
          "appType": "SERVICE_KEY",
          "currentUsage": 1
        }
      ]
    }
  ]
}
```

The table below provides details on the properties returned in the `results` array of the response:

| Property | Type | Description |
| - | - | - |
| `name` | String | An identifier used by HubSpot for the API call. |
| `usageLimit` | Number | The [daily limit](/docs/developer-tooling/platform/usage-guidelines#privately-distributed-app-limits) for your apps. |
| `currentUsage` | Number | The total number of calls your apps have made during the current period (starting from midnight of the current day). |
| `collectedAt` | String | An ISO 8601 timestamp denoting when usage was measured. |
| `fetchStatus` | String | An enumeration denoting the status of the usage request. |
| `resetsAt` | String | An ISO 8601 timestamp denoting when the current period of usage will reset. |
| `usageByAppType` | Array | Usage details broken out by app type. Each entry in the list includes two fields: <ul><li>`appType`: The type of app, which can be [`LEGACY_PRIVATE_APP`](/docs/apps/legacy-apps/private-apps/overview), [`DEVELOPER_PLATFORM_APP`](/docs/apps/developer-platform/build-apps/create-an-app), or [`SERVICE_KEY`](/docs/apps/developer-platform/build-apps/authentication/account-service-keys).</li><li>`currentUsage`: The total number of calls made by apps of that type (starting from midnight of the current day).</li></ul> |
