---
title: "Read a batch of bucket_test111s by internal ID, or unique property values"
method: POST
path: "/crm/v3/objects/bucket_test111s/batch/read"
tags: ["Batch"]
---

# Read a batch of bucket_test111s by internal ID, or unique property values

`POST /crm/v3/objects/bucket_test111s/batch/read`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/v3/objects/bucket_test111s/batch/read`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.contacts.read`
  - API key in header `private-app`
- TypeScript: <https://skmtc.dev/hubspot/apis/crm-bucket-test111/docs/crm/v3/objects/bucket_test111s/batch/read/post.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `archived` boolean

## Request body

- BatchReadInputSimplePublicObjectId
  - `propertiesWithHistory` string[], required
  - `idProperty` string
  - `inputs` SimplePublicObjectId[], required
    - `id` string, required
  - `properties` string[], required

## Response `200`

successful operation

- BatchResponseSimplePublicObject
  - `completedAt` string, date-time, required
  - `requestedAt` string, date-time
  - `startedAt` string, date-time, required
  - `links` object
  - `results` SimplePublicObject[], required
    - `createdAt` string, date-time, required
    - `archived` boolean
    - `archivedAt` string, date-time
    - `propertiesWithHistory` object
    - `id` string, required
    - `properties` object, required
    - `updatedAt` string, date-time, required
  - `status` 'PENDING' | 'PROCESSING' | 'CANCELED' | 'COMPLETE', required

## Other responses

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

---

[API](https://skmtc.dev/hubspot/apis/crm-bucket-test111.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-bucket-test111/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-bucket-test111/revisions/753e27fbbe95?raw)