Passer au contenu principal
POST
/
crm
/
objects
/
2026-03
/
{objectType}
/
search
Rechercher des rendez-vous
curl --request POST \
  --url https://api.hubapi.com/crm/objects/2026-03/{objectType}/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "after": "<string>",
  "filterGroups": [
    {
      "filters": [
        {
          "operator": "BETWEEN",
          "propertyName": "<string>",
          "highValue": "<string>",
          "value": "<string>",
          "values": [
            "<string>"
          ]
        }
      ]
    }
  ],
  "limit": 123,
  "properties": [
    "<string>"
  ],
  "sorts": [
    "<string>"
  ],
  "query": "<string>"
}
'
{
  "results": [
    {
      "archived": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "properties": {},
      "updatedAt": "2023-11-07T05:31:56Z",
      "archivedAt": "2023-11-07T05:31:56Z",
      "objectWriteTraceId": "<string>",
      "propertiesWithHistory": {},
      "url": "<string>"
    }
  ],
  "total": 123,
  "paging": {
    "next": {
      "after": "<string>",
      "link": "<string>"
    },
    "prev": {
      "before": "<string>",
      "link": "<string>"
    }
  }
}

Supported products

Autorisations

Authorization
string
header
requis

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

Paramètres de chemin

objectType
string
requis

objectTypeId de type d'objet

Corps

application/json

Décrit une demande de recherche

after
string
requis

Un jeton de curseur de pagination pour récupérer les pages suivantes.

filterGroups
object[]
requis

Jusqu'à 6 groupes de filtres définissant des critères d'interrogation supplémentaires.

limit
integer<int32>
requis

Le nombre maximum de résultats à renvoyer, jusqu'à 200 objets.

properties
string[]
requis

Une liste de noms de propriétés à inclure dans la réponse.

sorts
string[]
requis

Spécifie l'ordre de tri basé sur les propriétés de l'objet.

query
string

La chaîne de requête de la recherche, jusqu'à 3 000 caractères.

Réponse

successful operation

Représente une liste d'objets simples renvoyés par une requête API, ainsi que le nombre total d'objets disponibles.

results
object[]
requis
total
integer<int32>
requis

Le nombre de résultats disponibles

paging
object
Last modified on April 14, 2026