Account information API

The following endpoints provide information about a given HubSpot account, including the account settings, and API usage details for developer platform apps, integrations using service keys, and legacy private apps.

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:

{
  "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.
`portalName`	String	The configured name of the HubSpot account.
`accountType`	String	An enumeration corresponding to the account type: `STANDARD`: a standard HubSpot account. `DEVELOPER_TEST`: a developer test account. `SANDBOX`: a sandbox account. `APP_DEVELOPER`: a legacy developer account.
`timeZone`	String	The name of the account’s configured timezone (e.g., `"US/Eastern"`).
`companyCurrency`	String	The currency code of the account’s configured currency.
`additionalCurrencies`	Array	An array of additional 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, integrations using service keys, and legacy private apps. 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. 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:

{
  "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 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: `appType`: The type of app, which can be `LEGACY_PRIVATE_APP`, `DEVELOPER_PLATFORM_APP`, or `SERVICE_KEY`. `currentUsage`: The total number of calls made by apps of that type (starting from midnight of the current day).

Account & Settings

Automation

CMS

CRM

Marketing

Meetings

Querying data

Reporting

Revenue

Account information API

Get account details for a HubSpot account

Check daily API usage and limits for apps in your account

​Get account details for a HubSpot account

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

Get account details for a HubSpot account

Check daily API usage and limits for apps in your account