メインコンテンツへスキップ
POST
/
communication-preferences
/
2026-03
/
statuses
/
batch
/
read
配信登録ステータスをバッチで取得
curl --request POST \
  --url https://api.hubapi.com/communication-preferences/2026-03/statuses/batch/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    "<string>"
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "statuses": [
        {
          "source": "<string>",
          "subscriberIdString": "<string>",
          "subscriptionId": 123,
          "timestamp": "2023-11-07T05:31:56Z",
          "businessUnitId": 123,
          "legalBasisExplanation": "<string>",
          "subscriptionName": "<string>"
        }
      ],
      "subscriberIdString": "<string>"
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "links": {},
  "requestedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.jp/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

承認

Authorization
string
header
必須

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

クエリパラメータ

channel
enum<string>
必須

配信登録ステータスを絞り込むためのコミュニケーションチャネル。「EMAIL」である必要があります。

利用可能なオプション:
EMAIL
businessUnitId
integer<int64>

ビジネスユニットIDを表す任意の整数。このパラメーターは、特定のビジネスユニットに基づいて結果を絞り込むのに役立ちます。

ボディ

application/json
inputs
string[]
必須

バッチ処理の入力を表す文字列のリスト。

レスポンス

successful operation

completedAt
string<date-time>
必須

バッチ処理が完了した日時。

results
object[]
必須

バッチ処理の結果の配列。それぞれに配信登録ステータス情報が含まれます。

startedAt
string<date-time>
必須

バッチ処理が始まった日時。

status
enum<string>
必須

次の値を取り得る、バッチ処理の現在のステータス:PENDING、PROCESSING、CANCELED、COMPLETE.

利用可能なオプション:
CANCELED,
COMPLETE,
PENDING,
PROCESSING

バッチレスポンスに関連付けられた関連リンクのコレクション。

requestedAt
string<date-time>

バッチリクエストが行われた日時。

Last modified on May 11, 2026