---
title: "Read a batch of deal split objects by their associated deal object internal ID"
method: POST
path: "/crm/objects/v3/deals/splits/batch/read"
tags: ["Batch"]
---

# Read a batch of deal split objects by their associated deal object internal ID

`POST /crm/objects/v3/deals/splits/batch/read`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/objects/v3/deals/splits/batch/read`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.dealsplits.read_write`

Read a batch of deal split objects by their associated deal object internal ID

## Request body

- BatchInputPublicObjectId
  - `inputs` PublicObjectId[], required: An array of deal split inputs
    - `id` string, required: The unique identifier for the public object.

## Response `200`

successful operation

- BatchResponseDealToDealSplits
  - `completedAt` string, date-time, required: The timestamp indicating when the batch operation was completed, in date-time format.
  - `links` object: A map of link names to associated URIs for additional resources or documentation.
  - `requestedAt` string, date-time: The timestamp indicating when the batch operation was requested, in date-time format.
  - `results` DealToDealSplits[], required: An array of deal-to-deal split objects representing the results of the batch operation.
    - `id` string, required: The unique identifier for the deal associated with the deal splits.
    - `splits` SimplePublicObject[], required: An array of deal split objects, each representing a portion of the deal assigned to an owner.
      - `archived` boolean, required: Whether the object is archived.
      - `archivedAt` string, date-time: The timestamp when the object was archived, in ISO 8601 format.
      - `createdAt` string, date-time, required: The timestamp when the object was created, in ISO 8601 format.
      - `id` string, required: The unique ID of the object.
      - `objectWriteTraceId` string: An identifier used to trace the write request for the object. Set a unique ID for each write operation; it is returned with any errors so you can identify which request encountered which error.
      - `properties` object, required: Key-value pairs representing the properties of the object.
      - `propertiesWithHistory` object: Key-value pairs representing the properties of the object along with their history, each with a timestamp and source information.
      - `updatedAt` string, date-time, required: The timestamp when the object was last updated, in ISO 8601 format.
      - `url` string: The URL associated with the object.
  - `startedAt` string, date-time, required: The timestamp indicating when the batch operation started, in date-time format.
  - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING', required: The current status of the batch operation, with possible values: CANCELED, COMPLETE, PENDING, PROCESSING.

## Other responses

- `207`: multiple statuses
- `default`: An error occurred.

## 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
  - …11 more
- **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
  - …11 more
- **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`

[Operation history](https://skmtc.dev/hubspot/apis/crm-deal-splits/changes/crm/objects/v3/deals/splits/batch/read/post.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-deal-splits.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-deal-splits/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-deal-splits/revisions/7149a0837379?raw)