Zum Hauptinhalt springen
POST
/
crm
/
lists
/
2026-03
/
search
cURL
curl --request POST \
  --url https://api.hubapi.com/crm/lists/2026-03/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "additionalProperties": [
    "<string>"
  ],
  "listIds": [
    "<string>"
  ],
  "offset": 123,
  "processingTypes": [
    "<string>"
  ],
  "count": 123,
  "objectTypeId": "<string>",
  "query": "<string>",
  "sort": "<string>"
}
'
{
  "hasMore": true,
  "lists": [
    {
      "additionalProperties": {},
      "listId": "<string>",
      "listVersion": 123,
      "name": "<string>",
      "objectTypeId": "<string>",
      "processingStatus": "<string>",
      "processingType": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "createdById": "<string>",
      "deletedAt": "2023-11-07T05:31:56Z",
      "filtersUpdatedAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "updatedById": "<string>"
    }
  ],
  "offset": 123,
  "total": 123
}

Documentation Index

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

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

Supported products

Autorisierungen

Authorization
string
header
erforderlich

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

Body

application/json
additionalProperties
string[]
erforderlich

Die Eigenschaftsnamen aller zusätzlichen Listeneigenschaften, die in die Antwort aufgenommen werden sollen. Eigenschaften, die für eine bestimmte Liste nicht vorhanden oder leer sind, werden nicht in die Antwort aufgenommen.

Standardmäßig werden bei allen Anfragen die folgenden Eigenschaften für jede Liste abgerufen: „hs_list_size“, „hs_last_record_added_at“, „hs_last_record_removed_at“, „hs_folder_name“ und „hs_list_reference_count“.

listIds
string[]
erforderlich

ILS-Listen-IDs, die in den Suchergebnissen enthalten sein sollen. Sofern nicht angegeben, werden alle Listen berücksichtigt, die andere Kriterien erfüllen.

offset
integer<int32>
erforderlich

Wert, der zur Seitennummerierung in Listen verwendet wird. Der in der Antwort bereitgestellte „Versatz“ kann bei der nächsten Anfrage verwendet werden, um die nächste Seite der Ergebnisse abzurufen. Standardwert „0“, wenn kein Versatz angegeben wird.

processingTypes
string[]
erforderlich

Listenverarbeitungstypen, die in den Suchergebnissen enthalten sein sollen. Sofern nicht angegeben, werden alle Listen mit allen Verarbeitungstypen berücksichtigt.

count
integer<int32>

Die Anzahl der Listen, die in die Antwort enthalten sein sollen. Der Standardwert ist „20“, wenn kein Wert angegeben wird. Die maximale Anzahl ist „500“.

objectTypeId
string
query
string

Die „Abfrage“, die für die Suche nach Listen anhand des Listennamens verwendet wird. Wenn keine „Abfrage“ angegeben wird, sind in den Ergebnissen alle Listen enthalten.

sort
string

Sortierfeld und -reihenfolge

Antwort

successful operation

hasMore
boolean
erforderlich

Ob es noch mehr Ergebnisse gibt, die durchgeblättert werden müssen oder nicht.

lists
object[]
erforderlich

Die Listen, die den Suchkriterien entsprechen.

offset
integer<int32>
erforderlich

Wert, der in einer zukünftigen Anfrage zur Seitennummerierung in den Suchergebnissen der Liste übergeben werden soll.

total
integer<int32>
erforderlich

Die Gesamtzahl der Listen, die den Suchkriterien entsprechen.

Last modified on May 26, 2026