---
title: "Get a set of rows"
method: POST
path: "/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/batch/read"
tags: ["Rows"]
---

# Get a set of rows

`POST /cms/hubdb/2026-03/tables/{tableIdOrName}/rows/batch/read`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/batch/read`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `hapikey`
  - none

Returns rows in the published version of the specified table, given a set of row IDs.
**Note:** This endpoint can be accessed without any authentication if the table is set to be allowed for public access.

## Path parameters

- `tableIdOrName` string, required

## Request body

- BatchInputString
  - `inputs` string[], required: Strings to input.

## Response `200`

successful operation

- CmsHubdbBatchResponseHubDbTableRowV3
  - `completedAt` string, date-time, required: The timestamp indicating when the batch processing was completed.
  - `links` object: A collection of related links associated with the batch response.
  - `requestedAt` string, date-time: The timestamp indicating when the batch request was made.
  - `results` CmsHubdbHubDbTableRowV3[], required
    - `childTableId` string, required: Specifies the value for the column child table id
    - `createdAt` string, date-time, required: Timestamp at which the row is created
    - `id` string, required: The id of the table row
    - `name` string, required: Specifies the value for `hs_name` column, which will be used as title in the dynamic pages
    - `path` string, required: Specifies the value for `hs_path` column, which will be used as slug in the dynamic pages
    - `publishedAt` string, date-time, required: The timestamp indicating when the row was last published, in date-time format.
    - `updatedAt` string, date-time, required: Timestamp at which the row is updated last time
    - `values` object, required: List of key value pairs with the column name and column value
  - `startedAt` string, date-time, required: The timestamp indicating when the batch processing began.
  - `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

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-04-08** `b0d8bc008db9`: 1 info
  - api operation id `post-/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/batch/read_readTableRows` removed and replaced with `post-/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/batch/read`
- **2026-04-01** `e0403341222c`: 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-30** `dc2fdad57f7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/cms/hubdb/2026-03/tables/:tableIdOrName/rows/batch/read/post.md)

---

[API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) - [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/hubspot-api-specification/revisions/f9c7181056c5?raw)