Check daily API usage

Last updated June 17, 2020

GET /integrations/v1/limit/daily

Method Details

HTTP Methods:

GET

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing & CRM

Use this endpoint to see how many API calls an account has made for the current day. The current day is measured from midnight to midnight based on the connected account's time zone settings.

See the API Usage Guidelines for more details about HubSpot's API limits, and this page for details about working with those limits.

The data returned returned by this endpoint will be cached for 5 minutes.  Check the fetchStatus and collectedAt fields in the response to determine if the response was from cache.

Notes: This endpoint tracks daily API usage for integrations using a HubSpot API key (hapikey), and therefore requires an API key for authentication. To track the usage for an OAuth app, you can use the request monitoring in the app settings.

A call to this endpoint counts against your API limits.

Required Parameters How to use Description
HubSpot API key hapikey=
used in the request URL		 The API key for the HubSpot account you want to check the API usage of.

Example URL: https://api.hubapi.com/integrations/v1/limit/daily?hapikey=demo

About

Jobs

Learn Inbound

Support

Locations

HubSpot, Inc.
25 First Street, 2nd Floor
Cambridge, MA 02141
European Headquarters
Ground Floor, Two Dockland Central
Guild Street, Dublin 1
Asia/Pacific Office
20 Hunter St, Level 7
Sydney NSW 2000
View our other locations
Example GET URL: https://api.hubapi.com/integrations/v1/limit/daily?hapikey=demo Example response: [ { "name": "api-calls-daily", "usageLimit": 1000000, "currentUsage": 31779, "collectedAt": 1560189939285, "fetchStatus": "SUCCESS", "resetsAt": 1560204000000 } ] The 'resetsAt' field is a Unix timestamp (in milliseconds) of the time that the limit will reset. The limit resets at midnight, based on the time zone setting of the account. When the response is from cache, the 'fetchStatus' will be "CACHED", and the 'collectedAt' will be a Unix timestamp in milliseconds indicating when the cache was last updated: [ { "name": "api-calls-daily", "usageLimit": 1000000, "currentUsage": 31779, "collectedAt": 1560189939285, "fetchStatus": "CACHED", "resetsAt": 1560204000000 } ]