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

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

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

## 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.net/hubspot/apis/crm-payments.md) · [All operations](https://skmtc.net/hubspot/apis/crm-payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/crm-payments/revisions/68e0c18a565e/schema)