Skip to main content
POST
/
cms
/
v3
/
blogs
/
tags
/
batch
/
read
Retrieve a batch of Blog Tags
curl --request POST \
  --url https://api.hubapi.com/cms/v3/blogs/tags/batch/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    "<string>"
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "links": {},
  "requestedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "name": "<string>",
      "created": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "language": "aa",
      "slug": "<string>",
      "translatedFromId": 123,
      "updated": "2023-11-07T05:31:56Z"
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED"
}

Supported products

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

archived
boolean

Specifies whether to return deleted Blog Tags. Defaults to false.

Body

application/json

The JSON array of Blog Tag ids.

Wrapper for providing an array of strings as inputs.

inputs
string[]
required

JSON nodes to input.

Response

successful operation

Response object for batch operations on blog tags.

completedAt
string<date-time>

Time of batch operation completion.

Links associated with batch operation.

requestedAt
string<date-time>

Time of batch operation request.

results
object[]

Results of batch operation.

startedAt
string<date-time>

Time of batch operation start.

status
enum<string>

Status of batch operation.

Available options:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
Last modified on February 12, 2026