> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Search Lists > Rechercher des listes dans votre compte HubSpot à l’aide de divers critères. Ce point de terminaison vous permet de filtrer et de récupérer des listes en fonction de paramètres de recherche spécifiques, ce qui facilite la gestion et l’organisation efficace de vos listes. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/crm-lists-v2026-09.json POST /crm/lists/2026-09/search openapi: 3.0.1 info: title: CRM Lists description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Batch - name: Search paths: /crm/lists/2026-09/search: post: tags: - Search summary: Rechercher des listes description: >- Rechercher des listes dans votre compte HubSpot à l’aide de divers critères. Ce point de terminaison vous permet de filtrer et de récupérer des listes en fonction de paramètres de recherche spécifiques, ce qui facilite la gestion et l’organisation efficace de vos listes. operationId: post-/crm/lists/2026-09/search parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/ListSearchRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ListSearchResponse' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.segments.read - oauth2: - crm.lists.read components: schemas: ListSearchRequest: required: - additionalProperties - listIds - offset - processingTypes type: object properties: additionalProperties: type: array description: >- Un tableau de chaînes de caractères représentant des propriétés supplémentaires à inclure dans la recherche. items: type: string count: type: integer description: Un entier spécifiant le nombre de résultats à renvoyer. format: int32 listIds: type: array description: >- Un tableau de chaînes de caractères spécifiant les ID des listes à rechercher. items: type: string objectTypeId: type: string description: >- Une chaîne représentant l'ID du type d'objet pour filtrer les listes. offset: type: integer description: >- Un entier utilisé pour la pagination, indiquant le point de départ des résultats de recherche. format: int32 processingTypes: type: array description: >- Un tableau de chaînes de caractères indiquant les types de traitement à appliquer aux résultats de la recherche. items: type: string query: type: string description: >- Une chaîne représentant la requête de recherche pour filtrer les listes. sort: type: string description: >- Une chaîne spécifiant les critères de tri pour les résultats de recherche. ListSearchResponse: required: - hasMore - lists - offset - total type: object properties: hasMore: type: boolean description: >- Un booléen indiquant si d'autres résultats sont disponibles au-delà de la page actuelle. lists: type: array description: >- Un tableau d'objets représentant les listes trouvées dans la recherche, chacun étant conforme au schéma PublicObjectListSearchResult. items: $ref: '#/components/schemas/PublicObjectListSearchResult' offset: type: integer description: >- Un entier indiquant la position dans la liste des résultats où commence la page actuelle. format: int32 total: type: integer description: >- Un entier indiquant le nombre total de listes trouvées par la recherche. format: int32 PublicObjectListSearchResult: required: - additionalProperties - listId - listVersion - name - objectTypeId - processingStatus - processingType type: object properties: additionalProperties: type: object additionalProperties: type: string description: >- Un objet contenant des propriétés supplémentaires de la liste, chaque propriété étant représentée sous forme de chaîne de caractères. createdAt: type: string description: La date et l'heure de création de la liste, au format ISO 8601. format: date-time createdById: type: string description: >- L'identifiant unique de l'utilisateur qui a créé la liste, représenté sous forme de chaîne de caractères. deletedAt: type: string description: La date et l'heure de suppression de la liste, au format ISO 8601. format: date-time filtersUpdatedAt: type: string description: >- La date et l'heure de la dernière mise à jour des filtres de la liste, au format ISO 8601. format: date-time listId: type: string description: >- L'identifiant unique de la liste, représenté sous forme de chaîne de caractères. listVersion: type: integer description: Un entier indiquant la version de la liste. format: int32 name: type: string description: Le nom de la liste, représenté sous forme de chaîne de caractères. objectTypeId: type: string description: >- L'identifiant unique du type d'objet associé à la liste, représenté sous forme de chaîne de caractères. processingStatus: type: string description: >- Une chaîne de caractères représentant le statut de traitement actuel de la liste. processingType: type: string description: >- Chaîne de caractères indiquant le type de traitement appliqué à la liste. updatedAt: type: string description: >- La date et l'heure de la dernière mise à jour de la liste, au format ISO 8601. format: date-time updatedById: type: string description: >- L'identifiant unique de l'utilisateur ayant mis à jour la liste en dernier, représenté sous forme de chaîne de caractères. Error: required: - category - correlationId - message type: object properties: category: type: string description: Une chaîne indiquant la catégorie de l'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant un contexte additionnel sur l'erreur, représenté sous forme de carte de paires clé-valeur. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour l'instance d'erreur, utilisé à des fins de suivi et de débogage. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Un tableau d'objets ErrorDetail, chacun fournissant des informations supplémentaires sur les erreurs spécifiques qui se sont produites. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Un objet contenant des liens connexes, représenté sous forme de mappage des noms de liens vers des URL. message: type: string description: >- Une chaîne qui fournit une description de l'erreur lisible par un humain. example: An error occurred subCategory: type: string description: >- Un objet représentant une classification plus spécifique de l'erreur au sein de sa catégorie. description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base ErrorDetail: required: - message type: object properties: code: type: string description: >- Une chaîne représentant un code d'erreur spécifique qui identifie le type d'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant un contexte additionnel sur l'erreur, représenté comme une carte de chaînes de caractères vers des tableaux de chaînes de caractères, qui peut inclure des paramètres ou des valeurs spécifiques liés à l'erreur. example: '{missingScopes=[scope1, scope2]}' in: type: string description: "Une chaîne indiquant l'emplacement où l'erreur s'est produite, tel que «\_query\_», «\_header\_» ou «\_body\_»." message: type: string description: Une chaîne contenant une description de l'erreur lisible. subCategory: type: string description: >- Un objet fournissant une catégorisation supplémentaire de l'erreur, qui peut contenir des détails supplémentaires. description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: cms.membership.access_groups.write: '' crm.lists.read: '' crm.lists.write: '' crm.segments.read: '' crm.segments.write: '' ````