---
title: "Changes to Retrieve multiple custom object schemas in a batch request."
method: POST
path: "/crm-object-schemas/2026-03/schemas/batch/read"
---

# Changes to Retrieve multiple custom object schemas in a batch request.

`POST /crm-object-schemas/2026-03/schemas/batch/read`

> Every recorded change to this operation, newest first.
> 14 revisions in range; 1 not diffed, 2 could not be searched.

## Timeline

Changed in 6 of 14 revisions.

- **2026-04-08** `b0d8bc008db9`: 3 info
- **2026-04-03** `3578967e48df`: 3 info
- **2026-04-01** `e0403341222c`: 2 info
- **2026-03-31** `f33be5a82610`: 2 info
- **2026-03-30** `dc2fdad57f7f`: 22 breaking, 5 warning, 4 info
- **2026-03-25** `62586336cea2`: 1 info

## Changes

- **2026-04-08** `b0d8bc008db9`: 3 info
  - api operation id `post-/crm-object-schemas/2026-03/schemas/batch/read_/crm-object-schemas/v3/schemas/batch/read` removed and replaced with `post-/crm-object-schemas/2026-03/schemas/batch/read`
  - the security scope `crm.objects.custom.read` was added to the endpoint's security scheme `private_apps`
  - the security scope `oauth` was removed from the endpoint's security scheme `private_apps`
- **2026-04-03** `3578967e48df`: 3 info
  - the security scope `crm.objects.custom.read` was added to the endpoint's security scheme `private_apps`
  - the security scope `oauth` was removed from the endpoint's security scheme `private_apps`
  - added the optional property `results/items/properties/items/currencyPropertyName` to the response with the `200` status
- **2026-04-01** `e0403341222c`: 2 info
  - the security scope `crm.objects.custom.read` was added to the endpoint's security scheme `private_apps`
  - the security scope `oauth` was removed from the endpoint's security scheme `private_apps`
- **2026-03-31** `f33be5a82610`: 2 info
  - the security scope `crm.objects.custom.read` was added to the endpoint's security scheme `private_apps`
  - the security scope `oauth` was removed from the endpoint's security scheme `private_apps`
- **2026-03-30** `dc2fdad57f7f`: 22 breaking, 5 warning, 4 info
  - the response property `results/items/associations/items/name` became optional for the status `200`
  - the `results/items/associations/items/id` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `200`
  - removed the required property `results/items/associations/items/allowsCustomLabels` from the response with the `200` status
  - removed the required property `results/items/associations/items/cardinality` from the response with the `200` status
  - removed the required property `results/items/associations/items/category` from the response with the `200` status
  - removed the required property `results/items/associations/items/hasAllAssociatedObjects` from the response with the `200` status
  - removed the required property `results/items/associations/items/hasCascadingDeletes` from the response with the `200` status
  - removed the required property `results/items/associations/items/hasUserEnforcedMaxFromObjectIds` from the response with the `200` status
  - removed the required property `results/items/associations/items/hasUserEnforcedMaxToObjectIds` from the response with the `200` status
  - removed the required property `results/items/associations/items/hidden` from the response with the `200` status
  - removed the required property `results/items/associations/items/inverseAllowsCustomLabels` from the response with the `200` status
  - removed the required property `results/items/associations/items/inverseCardinality` from the response with the `200` status
  - removed the required property `results/items/associations/items/inverseHasAllAssociatedObjects` from the response with the `200` status
  - removed the required property `results/items/associations/items/inverseId` from the response with the `200` status
  - removed the required property `results/items/associations/items/inverseName` from the response with the `200` status
  - removed the required property `results/items/associations/items/isDefault` from the response with the `200` status
  - removed the required property `results/items/associations/items/isInversePrimary` from the response with the `200` status
  - removed the required property `results/items/associations/items/isPrimary` from the response with the `200` status
  - removed the required property `results/items/associations/items/maxFromObjectIds` from the response with the `200` status
  - removed the required property `results/items/associations/items/maxToObjectIds` from the response with the `200` status
  - removed the required property `results/items/associations/items/portalUniqueIdentifier` from the response with the `200` status
  - removed the required property `results/items/associations/items/readOnly` from the response with the `200` status
  - removed the optional property `results/items/associations/items/fromObjectType` from the response with the `200` status
  - removed the optional property `results/items/associations/items/hiddenReason` from the response with the `200` status
  - removed the optional property `results/items/associations/items/inverseLabel` from the response with the `200` status
  - removed the optional property `results/items/associations/items/label` from the response with the `200` status
  - removed the optional property `results/items/associations/items/toObjectType` from the response with the `200` status
  - the security scope `crm.objects.custom.read` was added to the endpoint's security scheme `private_apps`
  - the security scope `oauth` was removed from the endpoint's security scheme `private_apps`
  - added the optional property `results/items/associations/items/createdAt` to the response with the `200` status
  - added the optional property `results/items/associations/items/updatedAt` to the response with the `200` status
- **2026-03-25** `62586336cea2`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/hubspot/apis/hubspot-api-specification/docs/crm-object-schemas/2026-03/schemas/batch/read/post.md) - [API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) - [Page](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/crm-object-schemas/2026-03/schemas/batch/read/post)