--- title: "Changes to Read a batch of deal split objects by their associated deal object internal ID" method: POST path: "/crm/objects/v3/deals/splits/batch/read" --- # Changes to Read a batch of deal split objects by their associated deal object internal ID `POST /crm/objects/v3/deals/splits/batch/read` > Every recorded change to this operation, newest first. ## Timeline Changed in 11 of 87 revisions. - **2026-09-03** (v3) `14469628f90c`: 1 info - **2026-07-13** (v3) `a68bed8482d6`: 1 breaking - **2026-06-15** (v3) `1a0006577adf`: 3 breaking, 12 info - **2026-06-15** (v3) `9a004bbe8fc8`: 13 breaking, 2 warning - **2026-05-22** (v3) `1a0006577adf`: 2 info - **2026-04-15** (v3) `3c1a9705d3f2`: 4 info - **2026-04-09** (v3) `32e2f440cb06`: 8 info - **2026-04-03** (v3) `115493c7451c`: 1 info - **2026-03-31** (v3) `8a89f49697a6`: 2 warning, 1 info - **2026-03-19** (v3) `c7a00d76b0b8`: 1 breaking, 2 info - **2026-02-10** (v3) `92c888c2f3d3`: 1 info ## Changes - **2026-09-03** (v3) `14469628f90c`: 1 info - endpoint added - **2026-07-13** (v3) `a68bed8482d6`: 1 breaking - api path removed without deprecation - **2026-06-15** (v3) `1a0006577adf`: 3 breaking, 12 info - the `errors/items/` response's property type changed from no type to `object` for status `207` - the `results/items/` response's property type changed from no type to `object` for status `200` - the `results/items/` response's property type changed from no type to `object` for status `207` - added the optional property `errors/items/id` to the response with the `207` status - added the optional property `errors/items/subCategory` to the response with the `207` status - added the required property `errors/items/category` to the response with the `207` status - added the required property `errors/items/context` to the response with the `207` status - added the required property `errors/items/errors` to the response with the `207` status - added the required property `errors/items/links` to the response with the `207` status - added the required property `errors/items/message` to the response with the `207` status - added the required property `errors/items/status` to the response with the `207` status - added the required property `results/items/id` to the response with the `200` status - added the required property `results/items/id` to the response with the `207` status - added the required property `results/items/splits` to the response with the `200` status - added the required property `results/items/splits` to the response with the `207` status - **2026-06-15** (v3) `9a004bbe8fc8`: 13 breaking, 2 warning - the `errors/items/` response's property type changed from `object` to no type for status `207` - the `results/items/` response's property type changed from `object` to no type for status `200` - the `results/items/` response's property type changed from `object` to no type for status `207` - removed the required property `errors/items/category` from the response with the `207` status - removed the required property `errors/items/context` from the response with the `207` status - removed the required property `errors/items/errors` from the response with the `207` status - removed the required property `errors/items/links` from the response with the `207` status - removed the required property `errors/items/message` from the response with the `207` status - removed the required property `errors/items/status` from the response with the `207` status - removed the required property `results/items/id` from the response with the `200` status - removed the required property `results/items/id` from the response with the `207` status - removed the required property `results/items/splits` from the response with the `200` status - removed the required property `results/items/splits` from the response with the `207` status - removed the optional property `errors/items/id` from the response with the `207` status - removed the optional property `errors/items/subCategory` from the response with the `207` status - **2026-05-22** (v3) `1a0006577adf`: 2 info - the security scope `crm.dealsplits.read_write` was added to the endpoint's security scheme `oauth2` - the security scope `deal-splits-access` was removed from the endpoint's security scheme `oauth2` - **2026-04-15** (v3) `3c1a9705d3f2`: 4 info - the endpoint scheme security `app_cookie` was removed from the API - the endpoint scheme security `hapikey` was removed from the API - the endpoint scheme security `internal_cookie` was removed from the API - the endpoint scheme security `shhkey` was removed from the API - **2026-04-09** (v3) `32e2f440cb06`: 8 info - api operation id `post-/crm/objects/v3/deals/splits/batch/read` removed and replaced with `post-/crm/objects/v3/deals/splits/batch/read_/crm/objects/v3/deals/splits/batch/read` - the endpoint scheme security `app_cookie` was added to the API - the endpoint scheme security `hapikey` was added to the API - the endpoint scheme security `internal_cookie` was added to the API - the endpoint scheme security `shhkey` was added to the API - the endpoint scheme security `private_apps` was removed from the API - the security scope `deal-splits-access` was added to the endpoint's security scheme `oauth2` - the security scope `crm.dealsplits.read_write` was removed from the endpoint's security scheme `oauth2` - **2026-04-03** (v3) `115493c7451c`: 1 info - api operation id `post-/crm/objects/v3/deals/splits/batch/read_/crm/objects/v3/deals/splits/batch/read` removed and replaced with `post-/crm/objects/v3/deals/splits/batch/read` - **2026-03-31** (v3) `8a89f49697a6`: 2 warning, 1 info - removed the optional property `errors` from the response with the `200` status - removed the optional property `numErrors` from the response with the `200` status - added the success response with the status `207` - **2026-03-19** (v3) `c7a00d76b0b8`: 1 breaking, 2 info - removed the success response with the status `207` - added the optional property `errors` to the response with the `200` status - added the optional property `numErrors` to the response with the `200` status - **2026-02-10** (v3) `92c888c2f3d3`: 1 info - endpoint added --- [Operation](https://skmtc.dev/hubspot/apis/crm-deal-splits/docs/crm/objects/v3/deals/splits/batch/read/post.md) - [API](https://skmtc.dev/hubspot/apis/crm-deal-splits.md) - [Page](https://skmtc.dev/hubspot/apis/crm-deal-splits/changes/crm/objects/v3/deals/splits/batch/read/post)