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

# Batch read

`POST /webhooks-journal/journal-local/2027-03-beta/batch/read`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/webhooks-journal/journal-local/2027-03-beta/batch/read`
- Auth: none required

Perform a batch read operation on the webhooks journal. This endpoint allows you to read multiple entries from the journal in a single request. It requires a JSON request body specifying the inputs to be read. The response includes the results of the batch read operation, and may return multiple statuses if there are errors.

## Query parameters

- `installPortalId` integer

## Request body

- BatchInputString
  - `inputs` string[], required: An array of strings to be processed. This property is required.

## 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 Pre-signed S3 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

- **2026-09-17** (2027-03-beta) `6995629a4549`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-08-14** (2027-03-beta) `0d8139833c65`: 1 info
  - api operation id `post-/webhooks-journal/journal-local/2027-03-beta/batch/read` removed and replaced with `post-/webhooks-journal/journal-local/2027-03-beta/batch/read_/webhooks-journal/journal-local/2027-03-beta/batch/read`
- **2026-08-13** (2027-03-beta) `a0b5c0b93ad0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/webhooks-webhooks/changes/webhooks-journal/journal-local/2027-03-beta/batch/read/post.md)

---

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