Passer au contenu principal
GET
/
crm
/
v3
/
lists
/
object-type-id
/
{objectTypeId}
/
name
/
{listName}
Récupérer la liste par nom
curl --request GET \
  --url https://api.hubapi.com/crm/v3/lists/object-type-id/{objectTypeId}/name/{listName} \
  --header 'Authorization: Bearer <token>'
{
  "list": {
    "createdAt": "2023-11-15T18:10:11.793Z",
    "createdById": "123",
    "filtersUpdatedAt": "2023-11-15T18:10:11.793Z",
    "listId": "1",
    "listVersion": 1,
    "name": "Manual List Example",
    "objectTypeId": "0-1",
    "processingStatus": "COMPLETE",
    "processingType": "MANUAL",
    "size": 330,
    "updatedAt": "2023-11-15T18:10:11.923Z",
    "updatedById": "123"
  }
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Autorisations

​
Authorization
string
header
requis

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

Paramètres de chemin

​
listName
string
requis

Le nom de la liste à récupérer. Ceci n'est pas sensible à la casse.

​
objectTypeId
string
requis

L'ID de type d'objet des types d'objets stockés par la liste à récupérer. Par exemple, « 0-1 » pour une liste de « CONTACT ».

Paramètres de requête

​
includeFilters
boolean
défaut:false

Un indicateur indiquant si la définition de la liste des objets de réponse doit inclure ou non une définition de branche de filtre. Par défaut, les définitions de la liste des objets n'incluront pas leurs définitions de branche de filtre dans la réponse.

Réponse

Successful response, for a request with includeFilters set to false.

The response for a list fetch request.

​
list
object
requis

An object list definition.

Last modified on March 30, 2026