メインコンテンツへスキップ
GET
/
contacts
/
v1
/
lists
/
batch
Get a group of contact lists
curl --request GET \
  --url https://api.hubapi.com/contacts/v1/lists/batch
import requests

url = "https://api.hubapi.com/contacts/v1/lists/batch"

response = requests.get(url)

print(response.text)
const options = {method: 'GET'};

fetch('https://api.hubapi.com/contacts/v1/lists/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/contacts/v1/lists/batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/contacts/v1/lists/batch"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.hubapi.com/contacts/v1/lists/batch")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/contacts/v1/lists/batch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
{
  "lists": [
    {
      "listId": 123,
      "name": "<string>",
      "dynamic": true,
      "portalId": 123,
      "createdAt": 123,
      "updatedAt": 123,
      "internalListId": 123,
      "deleteable": true,
      "metaData": {
        "processing": "<string>",
        "size": 123,
        "error": "<string>",
        "lastProcessingStateChangeAt": 123,
        "lastSizeChangeAt": 123
      },
      "filters": [
        [
          {}
        ]
      ]
    }
  ]
}

クエリパラメータ

listId
integer[]
必須

An integer that represents the list IDs that you want returned to your call. You can specify as many "listId" parameters as you wish to return multiple lists at once. Any list IDs that are invalid will be ignored.

レスポンス

200 - application/json

Successful response with group of contact lists

lists
object[]
最終更新日 2026年4月10日