---
title: "Retrieve API usage"
method: GET
path: "/account-info/2027-03-beta/api-usage/daily/privately-distributed"
tags: ["Basic"]
---

# Retrieve API usage

`GET /account-info/2027-03-beta/api-usage/daily/privately-distributed`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/account-info/2027-03-beta/api-usage/daily/privately-distributed`
- Auth: OAuth 2 (authorization code, authorization URL `https://app.hubspot.com/oauth/authorize`, token URL `https://api.hubapi.com/oauth/v1/token`, scopes: `account_info.api_usage.read`)

Retrieve the daily API usage for privately distributed apps in the account. This endpoint provides information about the current API usage, usage limits, and usage breakdown by app type. It is useful for monitoring and managing API consumption within your HubSpot account.

## Response `200`

successful operation

- ApiUsageMarch2027
  - `collectedAt` string, date-time, required: The date and time when the API usage data was collected, in ISO 8601 format.
  - `currentUsage` integer, required: An integer indicating the current amount of API usage.
  - `resetsAt` string, date-time: The date and time when the API usage limits will reset, in ISO 8601 format.
  - `usageByAppType` AppTypeUsage[], required: An array of objects detailing API usage by application type, each object conforming to the AppTypeUsage schema.
    - `appType` 'LEGACY_PRIVATE_APP' | 'PLATFORM_PRIVATE_APP' | 'SERVICE_KEY', required: A string indicating the type of application. Valid values include 'LEGACY_PRIVATE_APP', 'PLATFORM_PRIVATE_APP', and 'SERVICE_KEY'.
    - `apps` AppUsage[], required: An array of AppUsage objects, each detailing the usage statistics of individual applications within the specified app type.
      - `appId` integer, required: The unique identifier for the app, represented as an integer.
      - `currentUsage` integer, required: The current usage of the app, represented as an integer.
      - `name` string, required: The name of the app, represented as a string.
    - `currentUsage` integer, required: An integer representing the current usage count of the application type.
  - `usageLimit` integer, required: An integer representing the maximum allowed API usage.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-22** (2027-03-beta) `ebf3a85fda09`: 1 info
  - the endpoint scheme security `oauth2` was added to the API
- **2026-10-20** (2027-03-beta) `c0abd33b6cb3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/account-account-info/changes/account-info/2027-03-beta/api-usage/daily/privately-distributed/get.md)

---

[API](https://skmtc.dev/hubspot/apis/account-account-info.md) - [All operations](https://skmtc.dev/hubspot/apis/account-account-info/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/account-account-info/revisions/ebf3a85fda09?raw)