Zum Hauptinhalt springen
GET
/
crm
/
v3
/
lists
/
object-type-id
/
{objectTypeId}
/
name
/
{listName}
Liste anhand des Namens abrufen
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"
  }
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

Autorisierungen

​
Authorization
string
header
erforderlich

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

Pfadparameter

​
listName
string
erforderlich

Der Name der abzurufenden Liste. Zwischen Groß- und Kleinschreibung wird nicht unterschieden.

​
objectTypeId
string
erforderlich

Die Objekttyp-ID der Objekttypen, die in der abzurufenden Liste gespeichert sind. Beispiel: „0-1“ für eine „CONTACT“-Liste.

Abfrageparameter

​
includeFilters
boolean
Standard:false

Ein Flag, das angibt, ob die Definition der Antwortobjektliste eine Definition der Filterverzweigung enthalten soll oder nicht. Standardmäßig werden bei Objektlistendefinitionen keine Definitionen der Filterverzweigung in die Antwort aufgenommen.

Antwort

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

The response for a list fetch request.

​
list
object
erforderlich

An object list definition.

Last modified on March 24, 2026