Get a group of contact lists
curl --request GET \
--url https://api.hubapi.com/contacts/v1/lists/batchimport 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,
"listType": "STATIC",
"portalId": 123,
"createdAt": 123,
"updatedAt": 123,
"internalListId": 123,
"deleteable": true,
"metaData": {
"processing": "<string>",
"size": 123,
"error": "<string>",
"lastProcessingStateChangeAt": 123,
"lastSizeChangeAt": 123
},
"filters": [
[
{}
]
]
}
]
}v1
Get a group of contact lists
For a given account, return a set of contact lists that you specify with multiple listId parameters. This will return only the metadata on these lists and not all of the contacts in the list.
GET
/
contacts
/
v1
/
lists
/
batch
Get a group of contact lists
curl --request GET \
--url https://api.hubapi.com/contacts/v1/lists/batchimport 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,
"listType": "STATIC",
"portalId": 123,
"createdAt": 123,
"updatedAt": 123,
"internalListId": 123,
"deleteable": true,
"metaData": {
"processing": "<string>",
"size": 123,
"error": "<string>",
"lastProcessingStateChangeAt": 123,
"lastSizeChangeAt": 123
},
"filters": [
[
{}
]
]
}
]
}Parámetros de consulta
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.
Respuesta
200 - application/json
Successful response with group of contact lists
Show child attributes
Show child attributes
Última modificación el 3 de abril de 2026