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

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

`POST /deal-splits/2026-09/batch/read`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/deal-splits/2026-09/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: A boolean indicating whether this object is archived.
      - `archivedAt` string, date-time: The date and time when this object was archived, in ISO 8601 format.
      - `createdAt` string, date-time, required: The date and time when this object was created, in ISO 8601 format.
      - `id` string, required: The unique identifier for this object, represented as a string.
      - `objectWriteTraceId` string: A string identifier used for tracing write operations on this object.
      - `properties` object, required: A map of property names to their values, where each value is a string.
      - `propertiesWithHistory` object: A map of property names to arrays of historical values, each containing a value and its associated timestamp.
      - `updatedAt` string, date-time, required: The date and time when this object was last updated, in ISO 8601 format.
      - `url` string: A string representing the URL associated with this 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** (2026-09) `2d7360a2c99c`: 2 warning, 2 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
  - the endpoint scheme security `private_apps` was removed from the API
  - added the success response with the status `207`

[Operation history](https://skmtc.dev/hubspot/apis/crm-deal-splits/changes/deal-splits/2026-09/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/1d5aeccdba51?raw)