---
title: "Read a batch of campaigns"
method: POST
path: "/marketing/campaigns/2026-03/batch/read"
tags: ["Batch"]
---

# Read a batch of campaigns

`POST /marketing/campaigns/2026-03/batch/read`

This endpoint reads a batch of campaigns based on the provided input data and returns the campaigns along with their associated assets. 
The maximum number of items in a batch request is 50.
The campaigns in the response are not guaranteed to be in the same order as they were provided in the request.
If duplicate campaign IDs are provided in the request, duplicates will be ignored. The response will include only unique IDs and will be returned without duplicates.

## Query parameters

- `endDate` string
- `properties` string[]
- `startDate` string

## Request body

- MarketingCampaignsBatchInputPublicCampaignReadInput
  - `inputs` MarketingCampaignsPublicCampaignReadInput[], required — An array of PublicCampaignReadInput objects, each containing the ID of a campaign to be read. This property is required.
    - `id` string, required — The unique identifier for a campaign.

## Response `200`

successful operation

- MarketingCampaignsBatchResponsePublicCampaignWithAssets
  - `completedAt` string, date-time, required — The timestamp when the batch request processing was completed.
  - `links` object — A collection of URLs linking to related resources or documentation.
  - `requestedAt` string, date-time — The timestamp when the batch request was initially made.
  - `results` MarketingCampaignsPublicCampaignWithAssets[], required — An array of results from the batch operation, each representing a public campaign with assets.
    - `assets` object, required — Contains the assets associated with the campaign, each represented as a collection of campaign assets.
    - `businessUnits` MarketingCampaignsPublicBusinessUnit[], required — An array of business units associated with the campaign, each represented by a PublicBusinessUnit object.
      - `id` integer, required — The unique identifier for the business unit, represented as an integer.
    - `createdAt` string, date-time, required — The date and time when the campaign was created, formatted as a date-time string.
    - `id` string, required — The unique identifier for the campaign.
    - `properties` object, required — A map of key-value pairs representing the properties of the campaign.
    - `updatedAt` string, date-time, required — The date and time when the campaign was last updated, formatted as a date-time string.
  - `startedAt` string, date-time, required — The timestamp when the processing of the batch request began.
  - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING', required — The current processing status of the batch operation, with possible values: CANCELED, COMPLETE, PENDING, PROCESSING.

## Other responses

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

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)