topic Re: Limit for association count per object id for the batch read associations endpoint in APIs & Integrations

Limit for association count per object id for the batch read associations endpoint

RLehrhaupt — Tue, 10 Jun 2025 21:29:51 GMT

For the endpoint: "https://api.hubapi.com/crm/v4/associations/{fromObjectType}/{toObjectType}/batch/read"

I see that there is pagination on a per-object id basis for the 'inputs' parameter.

The following endpoint which is non-batch for a single object id "https://api.hubapi.com/crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType}" specifies that the 'limit' query parameter maximum is 500 associations per call.

I am looking for the equivalent 'limit' for the batch endpoint. The 'limit' parameter does not exist for the 'inputs' json, so I assume it's hard-fixed, but it would be useful for my development to know the preset limit. Is it 500 associations per object id? 500 associations across all object_ids with non-uniformity in the limit per object id? Is it 500/# of objects per object?

Thanks.

Re: Limit for association count per object id for the batch read associations endpoint

BérangèreL — Wed, 11 Jun 2025 13:42:30 GMT

Hi @RLehrhaupt, I hope that you are well!

Great question, thanks for asking the HubSpot Community!

I checked for you and I can see on this documentation "Bug Fix: Batch Read Limit for HubSpot Associations API" that, effective February 10th, 2025, any batch read requests submitted to the Associations API may not exceed 1000 IDs per request body. This change applies to all subscription tiers and impacts processes or integrations using the Batch Read functionality.

Is that what you were looking for?

If that's not the case, can you please share the HubSpot documentation where you cannot find the limit so that I'll investigate for you.

Thanks and have a great day!
Bérangère

Re: Limit for association count per object id for the batch read associations endpoint

RLehrhaupt — Wed, 11 Jun 2025 14:48:10 GMT

BérangèreL, thanks for the reply.

The batch limit of 1000 IDs is the limit of object IDs you can provide to a batch 'input' parameter in the request body. For the associations batch endpoint inside each element json of the 'input' there are two keys for 'id' and 'after'. The 'after' key is used to specify the offset for pagination.

For the associations endpoint, the response will get associations to another object for each ID provided separately. So if you provide 1000 contact ids and are looking for associations to companies, you will get a response that provides all the associations to each one of the 1000 IDs.

For the non-batch association LIST endpoint (https://api.hubapi.com/crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType}), the documentation says a limit of 500 associations will be returned for the singular object ID per page.

For the batch assocation endpoint (https://api.hubapi.com/crm/v4/associations/{fromObjectType}/{toObjectType}/batch/read) you can provide up to 1000 IDs but I'm trying to determine what the pagination limit is for the amount of associations per ID that will be in the response. Each ID has the 'after' parameter to specify pagination, which means there is some limit there. I do not see it listed in the documentation however.

Re: Limit for association count per object id for the batch read associations endpoint

GRajput — Mon, 16 Jun 2025 10:59:42 GMT

Hi @RLehrhaupt

HubSpot will return up to 500 associations per object ID in the batch response.
So if you pass 10 object IDs, you can get up to 500 × 10 = 5,000 associations in a single call.
If there are more than 500 associations for a given object ID, they will not be returned, and no paging is offered per ID in the batch endpoint.

I hope this will help you out. Please mark it as Solution Accepted and upvote to help another Community member.
Thanks!

Re: Limit for association count per object id for the batch read associations endpoint

RLehrhaupt — Mon, 16 Jun 2025 14:20:07 GMT

@GRajput thanks for the reply. In my testing for the endpoint "/crm/v4/associations/{fromObjectType}/{toObjectType}/batch/read" I have found that it has been able to return more than 500 associations per ID but I have not been able to test a limit. The schema for this endpoint in the HubSpot Docs page appears to denote a "paging" key inside each ID result response. Along with an 'after' key inside the 'inputs' array for the request body parameter.

I'm still not sure of the limit but I have just made a workaround for now in my automation scripts that raise an error if a pagination key is found (which is unlikely for my use case).

Re: Limit for association count per object id for the batch read associations endpoint

BérangèreL — Wed, 18 Jun 2025 14:00:47 GMT

Hi @RLehrhaupt, thanks for getting back to us and thanks @GRajput for your help!

I understand that you are using the batch read associations API but you are getting an error about a pagination key. Please let me know if that's not the case.

The more info, screenshots (without sensitive/confidential information), and details you can provide, the better the Community can assist.

I'd love to put you in touch with our Top Experts and Community Members who also use this API: Hi @PCronin9, @MaximeEsnol and @sylvain_tirreau do you have suggestions regarding the error, to help @RLehrhaupt, please?

@RLehrhaupt, regarding the limit, I am checking internally for you but I am glad you found a workaround for it!

Have a great day and thanks so much in advance for your help!
Bérangère

Re: Limit for association count per object id for the batch read associations endpoint

BérangèreL — Fri, 18 Jul 2025 06:37:32 GMT

Hi @RLehrhaupt, getting back to you on this.

So, we’re currently reviewing the limits internally to ensure they work well for everyone.

We’ll update the documentation as soon as possible.

Thanks so much for your patience and support!
Bérangère

Re: Limit for association count per object id for the batch read associations endpoint

BérangèreL — Fri, 01 Aug 2025 08:06:25 GMT

Hi @RLehrhaupt and thanks for your patience!

I checked internally for you and the limit is 11K.

I hope this helps!

Have a great day!
Bérangère

Re: Limit for association count per object id for the batch read associations endpoint

gogrow_dev — Thu, 29 Jan 2026 16:01:14 GMT

This doesn't answer the question, what's the associations limit per item returned in the batch endpoint?
I know that I can submit 1000 ids, how many assoc I will get for each id max?

Re: Limit for association count per object id for the batch read associations endpoint

Victor_Becerra — Thu, 29 Jan 2026 22:49:04 GMT

Hi @gogrow_dev — Thank you for your question.

You can find more context in these documents

https://developers.hubspot.com/docs/api-reference/crm-associations-v4/guide

https://developers.hubspot.com/changelog/bug-fix-batch-read-limit-for-hubspot-associations-api?

You can request associations for up to 1,000 records at a time using the batch endpoint. If a record has a lot of associations, HubSpot can return them in multiple pages, and you may need to make follow-up requests to get everything for that record.

Even though there's mention of an internal ~11K limit there isn't a limit that says how many associations you’ll get back for each individual record in one request. Because of that, I would recommend not to assume a fixed maximum per record.

My recommendation is to check whether more results are available for a record and request the next page when needed.

Hope it helps!

Victor

Re: Limit for association count per object id for the batch read associations endpoint

gogrow_dev — Fri, 30 Jan 2026 14:45:42 GMT

the pagination is confusing, and the doc doesn't spend to much talking about it.

example:
1. I send a post request to associations batch read endpoint including 5 ids.

2. I receive the associations per item, and all of them require pagination

My question is: would I have to paginate them separatedly? it's a bit unpractical the idea of having a batch endpoint if then, I have to send requests to paginate each of them.