---
title: "Batch read"
method: POST
path: "/webhooks-journal/journal/2026-03/batch/read"
tags: ["Batch"]
---

# Batch read

`POST /webhooks-journal/journal/2026-03/batch/read`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/webhooks-journal/journal/2026-03/batch/read`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `hapikey`
  - none

Execute a batch read operation on the webhooks journal for the specified date, 2026-03. This endpoint allows you to retrieve multiple entries from the webhooks journal in a single request, which can be useful for processing large amounts of data efficiently. Ensure that the request body is provided in the required format.

## Query parameters

- `installPortalId` integer

## Request body

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

## Response `200`

successful operation

- BatchResponseJournalFetchResponse
  - `completedAt` string, date-time, required: The date and time when the batch operation was completed, in ISO 8601 format.
  - `links` object: A map of link names to associated URIs related to the batch operation.
  - `requestedAt` string, date-time: The date and time when the batch operation was requested, in ISO 8601 format.
  - `results` JournalFetchResponse[], required: An array of results from the batch operation, each represented as a JournalFetchResponse object.
    - `currentOffset` string, uuid, required: The unique identifier for the current offset of the journal entry, formatted as a UUID.
    - `expiresAt` string, date-time, required: The date and time when the URL will expire, in ISO 8601 format.
    - `url` string, required: The URL where the journal entry can be accessed. It is a string.
  - `startedAt` string, date-time, required: The date and time when the batch operation started, in ISO 8601 format.
  - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING', required: The current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.

## Other responses

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

## Changes

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

- **2026-05-27** `f9c7181056c5`: 1 info
  - api operation id `post-/webhooks-journal/journal/2026-03/batch/read_/webhooks-journal/journal/2026-03/batch/read` removed and replaced with `post-/webhooks-journal/journal/2026-03/batch/read`
- **2026-04-08** `b0d8bc008db9`: 1 info
  - api operation id `post-/webhooks-journal/journal/2026-03/batch/read_/webhooks-journal/journal/2026-03/batch/read` removed and replaced with `post-/webhooks-journal/journal/2026-03/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/webhooks-journal/journal/2026-03/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)