---
title: "Batch retrieve campaigns"
method: POST
path: "/marketing/campaigns/2026-09/batch/read"
tags: ["Batch"]
---

# Batch retrieve campaigns

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

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/campaigns/2026-09/batch/read`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `marketing.campaigns.read`

Retrieve a batch of campaigns using specified parameters. This endpoint allows you to filter campaigns by date range and select specific properties to include in the response. It is useful for obtaining detailed information about multiple campaigns at once.

## Query parameters

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

## Request body

- BatchInputPublicCampaignReadInput
  - `inputs` PublicCampaignReadInput[], 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 the campaign. It is a string and is required to retrieve the campaign details.

## Response `200`

successful operation

- BatchResponsePublicCampaignWithAssets
  - `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, providing additional resources or documentation related to the batch operation.
  - `requestedAt` string, date-time: The date and time when the batch operation was requested, in ISO 8601 format.
  - `results` PublicCampaignWithAssets[], required: An array of PublicCampaignWithAssets objects, representing the campaigns involved in the batch operation.
    - `assets` object, required: A map of asset types to their respective collections of campaign assets, represented by CollectionResponsePublicCampaignAsset objects.
    - `businessUnits` PublicBusinessUnit[], 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 a 64-bit integer.
    - `createdAt` string, date-time, required: The date and time when the campaign was created, in ISO 8601 format.
    - `id` string, required: The unique identifier for the campaign, represented as a string.
    - `properties` object, required: A map of custom property names to their values, where each value is a string.
    - `updatedAt` string, date-time, required: The date and time when the campaign was last updated, in ISO 8601 format.
  - `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.

---

[API](https://skmtc.dev/hubspot/apis/marketing-campaigns-public-api.md) - [All operations](https://skmtc.dev/hubspot/apis/marketing-campaigns-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/marketing-campaigns-public-api/revisions/c1eb1c9b504c?raw)