Skip to main content
GET
/
crm
/
v3
/
limits
/
records
Read record limits
curl --request GET \
  --url https://api.hubapi.com/crm/v3/limits/records \
  --header 'Authorization: Bearer <token>'
{
  "customObjectTypes": {
    "byObjectType": [
      {
        "objectTypeId": "<string>",
        "pluralLabel": "<string>",
        "singularLabel": "<string>",
        "usage": 123
      }
    ],
    "overallLimit": 123,
    "overallPercentage": 123,
    "overallUsage": 123
  },
  "hubspotDefinedObjectTypes": [
    {
      "limit": 123,
      "objectTypeId": "<string>",
      "percentage": 123,
      "pluralLabel": "<string>",
      "singularLabel": "<string>",
      "usage": 123
    }
  ]
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Response

successful operation

customObjectTypes
object
required
hubspotDefinedObjectTypes
object[]
required
Last modified on December 16, 2025