> ## 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.
# Retrieve private app daily API usage
> Retrieve the daily API usage for private apps in the account. This endpoint provides insights into the API consumption patterns, helping users monitor and manage their API usage effectively.
export const ScopesList = ({scopes = [], description = "This API requires one of the following scopes:"}) => {
if (!scopes || scopes.length === 0) {
return null;
}
const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
return
;
};
## OpenAPI
````yaml specs/2026-09/account-account-info-v2026-09.json GET /account-info/2026-09/api-usage/daily/private-apps
openapi: 3.0.1
info:
title: Account Account Info
description: Basepom for all HubSpot Projects
version: 2026-09
x-hubspot-product-tier-requirements:
marketing: FREE
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Basic
paths:
/account-info/2026-09/api-usage/daily/private-apps:
get:
tags:
- Basic
summary: Retrieve API Usage
description: >-
Retrieve the daily API usage for private apps in the account. This
endpoint provides insights into the API consumption patterns, helping
users monitor and manage their API usage effectively.
operationId: get-/account-info/2026-09/api-usage/daily/private-apps
parameters: []
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: >-
#/components/schemas/CollectionResponseApiUsageMarch2027NoPaging
default:
$ref: '#/components/responses/Error'
description: ''
security: []
components:
schemas:
CollectionResponseApiUsageMarch2027NoPaging:
required:
- results
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/ApiUsageMarch2027'
ApiUsageMarch2027:
required:
- collectedAt
- currentUsage
- fetchStatus
- name
- usageByAppType
- usageLimit
type: object
properties:
collectedAt:
type: string
format: date-time
currentUsage:
type: integer
format: int32
fetchStatus:
type: string
enum:
- CACHED
- FAILURE
- NOTFOUND
- SUCCESS
- TIMEOUT
name:
type: string
resetsAt:
type: string
format: date-time
usageByAppType:
type: array
items:
$ref: '#/components/schemas/AppTypeUsage'
usageLimit:
type: integer
format: int32
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: The error category, represented as a string.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
An object containing context about the error condition. It maps
property names to arrays of strings.
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
A unique identifier for the request, represented as a UUID. Include
this value with any error reports or support tickets.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: >-
An array providing further information about the error, with each
item being an ErrorDetail object.
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
A map of link names to associated URIs containing documentation
about the error or recommended remediation steps. Each value is a
string.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate. It is a string.
example: An error occurred
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error, represented as a string.
description: >-
Represents an error response returned by the API when an operation
fails. This component is used in various endpoints to provide detailed
information about the error encountered.
example:
message: Invalid input (details will vary based on the error)
correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
category: VALIDATION_ERROR
links:
knowledge-base: https://www.hubspot.com/products/service/knowledge-base
AppTypeUsage:
required:
- appType
- currentUsage
type: object
properties:
appType:
type: string
enum:
- DEVELOPER_PLATFORM_APP
- LEGACY_PRIVATE_APP
- SERVICE_KEY
currentUsage:
type: integer
format: int32
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: The status code associated with the error detail. It is a string.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Context about the error condition, represented as an object where
each key is a string and each value is an array of strings.
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: >-
The name of the field or parameter in which the error was found. It
is a string.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate. It is a string.
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error. It is a string.
description: >-
Represents detailed information about an error that occurred in the API.
This component is used to provide additional context and specifics about
errors, typically as part of an error response.
responses:
Error:
description: An error occurred.
content:
'*/*':
schema:
$ref: '#/components/schemas/Error'
````
{product.name} -
{product.level}
)}