> ## 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 for leads > Effectuez une recherche de leads en fonction des groupes de filtres, des propriétés et des options de tri fournis. La requête permet la pagination et peut renvoyer jusqu'à 200 résultats par page. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/crm-leads-v2026-09.json POST /crm/objects/2026-09/leads/search openapi: 3.0.1 info: title: Leads 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 x-hubspot-api-use-case: >- Lorsqu'un contact existant montre un intérêt pour l'achat d'un produit ou d'un service, créez une fiche d'informations de lead pour suivre le parcours de prospection commerciale. x-hubspot-introduction: >- Dans HubSpot, les leads sont des contacts ou des entreprises qui ont manifesté un intérêt pour vos produits ou services et sont donc des clients potentiels. Utilisez l'API des leads pour créer et gérer des fiches d'informations de leads dans votre compte HubSpot, ainsi que pour synchroniser les données des leads entre HubSpot et d'autres systèmes. servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch - name: Search paths: /crm/objects/2026-09/leads/search: post: tags: - Search summary: Recherchez des leads à l'aide de critères spécifiques. description: "Effectuez une recherche de leads en fonction des groupes de filtres, des propriétés et des options de tri fournis. La requête permet la pagination et peut renvoyer jusqu'à 200\_résultats par page." operationId: >- post-/crm/objects/2026-09/leads/search_/crm/objects/2026-09-beta/{objectType}/search parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/PublicObjectSearchRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: >- #/components/schemas/CollectionResponseWithTotalSimplePublicObject default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.objects.deals.read - oauth2: - crm.objects.subscriptions.read - oauth2: - crm.objects.services.read - oauth2: - crm.objects.tickets.sensitive.read - oauth2: - crm.objects.orders.read - oauth2: - crm.objects.listings.write - oauth2: - crm.objects.custom.read - oauth2: - crm.objects.companies.write - oauth2: - crm.objects.tasks.read - oauth2: - crm.objects.custom.sensitive.write.v2 - oauth2: - crm.objects.custom.highly_sensitive.write.v2 - oauth2: - crm.objects.companies.read - oauth2: - crm.objects.appointments.sensitive.read.v2 - oauth2: - crm.objects.contacts.highly_sensitive.read.v2 - oauth2: - crm.objects.tickets.highly_sensitive.read - oauth2: - crm.objects.companies.sensitive.read.v2 - oauth2: - crm.objects.tickets.sensitive.write - oauth2: - media_bridge.read - oauth2: - crm.objects.deals.highly_sensitive.read.v2 - oauth2: - crm.objects.contacts.highly_sensitive.write.v2 - oauth2: - crm.objects.companies.highly_sensitive.read.v2 - oauth2: - crm.objects.commercepayments.write - oauth2: - crm.objects.invoices.write - oauth2: - crm.objects.contacts.sensitive.write.v2 - oauth2: - crm.objects.calls.read - oauth2: - crm.objects.users.write - oauth2: - crm.objects.meetings.read - oauth2: - crm.objects.custom.sensitive.read.v2 - oauth2: - crm.objects.users.read - oauth2: - crm.objects.partner-services.read - oauth2: - crm.objects.orders.write - oauth2: - crm.objects.partner-services.write - oauth2: - crm.objects.appointments.write - oauth2: - crm.objects.projects.highly_sensitive.write - oauth2: - crm.objects.carts.write - oauth2: - crm.objects.tickets.highly_sensitive.write - oauth2: - crm.objects.commercepayments.read - oauth2: - crm.objects.products.write - oauth2: - crm.objects.feedback_submissions.read - oauth2: - crm.objects.services.write - oauth2: - crm.objects.subscriptions.write - oauth2: - crm.objects.deals.sensitive.write.v2 - oauth2: - crm.objects.contacts.read - oauth2: - crm.objects.appointments.sensitive.write.v2 - oauth2: - crm.objects.projects.highly_sensitive.read - oauth2: - crm.objects.invoices.read - oauth2: - crm.objects.custom.write - oauth2: - tickets.sensitive.v2 - oauth2: - crm.objects.deals.write - oauth2: - e-commerce - oauth2: - crm.objects.appointments.read - oauth2: - crm.objects.projects.read - oauth2: - crm.objects.companies.sensitive.write.v2 - oauth2: - crm.objects.companies.highly_sensitive.write.v2 - oauth2: - crm.objects.deals.highly_sensitive.write.v2 - oauth2: - crm.objects.custom.highly_sensitive.read.v2 - oauth2: - crm.objects.goals.write - oauth2: - crm.objects.projects.sensitive.read - oauth2: - crm.objects.line_items.write - oauth2: - crm.objects.contacts.write - oauth2: - crm.objects.goals.read - oauth2: - crm.objects.line_items.read - oauth2: - crm.objects.partner-clients.write - oauth2: - crm.objects.projects.write - oauth2: - crm.objects.projects.sensitive.write - oauth2: - crm.objects.deals.sensitive.read.v2 - oauth2: - crm.objects.quotes.write - oauth2: - tickets.highly_sensitive.v2 - oauth2: - crm.objects.leads.read - oauth2: - crm.objects.leads.write - oauth2: - crm.objects.carts.read - oauth2: - crm.objects.emails.read - oauth2: - crm.objects.quotes.read - oauth2: - crm.objects.courses.write - oauth2: - crm.objects.partner-clients.read - oauth2: - crm.objects.notes.read - oauth2: - crm.objects.courses.read - oauth2: - crm.objects.listings.read - oauth2: - crm.objects.contacts.sensitive.read.v2 - oauth2: - crm.objects.products.read components: schemas: PublicObjectSearchRequest: required: - after - filterGroups - limit - properties - sorts type: object properties: after: type: string description: >- Chaîne servant de curseur pour la pagination, indiquant où commencer à renvoyer les résultats. filterGroups: type: array description: >- Un tableau de groupes de filtres utilisés pour affiner les résultats de recherche en fonction de critères spécifiés. items: $ref: '#/components/schemas/FilterGroup' limit: type: integer description: Un entier spécifiant le nombre maximal de résultats à renvoyer. format: int32 properties: type: array description: >- Un tableau de chaînes indiquant les propriétés des objets CRM à inclure dans les résultats de recherche. items: type: string query: type: string description: >- Une chaîne représentant la requête de recherche à appliquer aux objets CRM. sorts: type: array description: >- Un tableau de chaînes spécifiant l'ordre de tri des résultats de recherche. items: type: string description: Décrit une demande de recherche CollectionResponseWithTotalSimplePublicObject: required: - results - total type: object properties: paging: $ref: '#/components/schemas/Paging' results: type: array description: >- Un tableau d'éléments SimplePublicObject, chacun représentant un objet CRM dans la réponse. items: $ref: '#/components/schemas/SimplePublicObject' total: type: integer description: Le nombre de résultats disponibles format: int32 description: >- Représente une liste d'objets simples renvoyés par une requête API, ainsi que le nombre total d'objets disponibles. FilterGroup: required: - filters type: object properties: filters: type: array description: >- Un tableau d'objets de filtre qui définissent les critères de recherche. Chaque filtre spécifie une propriété, un opérateur et une valeur à filtrer. items: $ref: '#/components/schemas/Filter' description: >- Représente un groupe de filtres utilisés pour interroger des données dans HubSpot. Ce composant est utilisé pour définir des critères de filtrage des fiches d'informations dans divers points de terminaison d'API. Paging: type: object properties: next: $ref: '#/components/schemas/NextPage' prev: $ref: '#/components/schemas/PreviousPage' description: >- Représente les informations de pagination pour naviguer dans une liste de résultats de l'API. Il fournit des détails sur la manière d'accéder à l'ensemble de résultats précédent ou suivant. SimplePublicObject: required: - archived - createdAt - id - properties - updatedAt type: object properties: archived: type: boolean description: Un booléen indiquant si cet objet est archivé. archivedAt: type: string description: La date et l'heure d'archivage de cet objet, au format ISO 8601. format: date-time createdAt: type: string description: La date et l'heure de création de cet objet, au format ISO 8601. format: date-time id: type: string description: >- L'identifiant unique de cet objet, représenté sous forme de chaîne de caractères. objectWriteTraceId: type: string description: >- Une chaîne représentant l'ID de trace pour les opérations d'écriture sur cet objet. properties: type: object additionalProperties: type: string description: >- Une carte des noms de propriétés et de leurs valeurs, où chaque valeur est une chaîne de caractères. propertiesWithHistory: type: object additionalProperties: type: array items: $ref: '#/components/schemas/ValueWithTimestamp' description: >- Une carte des noms de propriétés vers des tableaux de valeurs historiques, chacun contenant une valeur et un horodatage. updatedAt: type: string description: >- La date et l'heure de la dernière mise à jour de cet objet, au format ISO 8601. format: date-time url: type: string description: Chaîne contenant l'URL de cet objet. warnings: type: array description: >- Un ensemble d'avertissements liés à cet objet, chacun contenant une catégorie, un message et un contexte. items: $ref: '#/components/schemas/PublicObjectWarning' description: Un objet public simple. Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur 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 Filter: required: - operator - propertyName type: object properties: highValue: type: string description: >- La valeur de la borne supérieure pour le filtrage basé sur une plage. Il s'agit d'une chaîne de caractères. operator: type: string description: "L'opérateur utilisé pour comparer la valeur de la propriété aux critères de filtre. Les opérateurs valides\_: «\_EQ\_», «\_NEQ\_», «\_LT\_», «\_LTE\_», «\_GT\_», «\_GTE\_», «\_BETWEEN\_», «\_IN\_», «\_NOT_IN\_», «\_HAS_PROPERTY\_», «\_NOT_HAS_PROPERTY\_», «\_CONTAINS_TOKEN\_» et «\_NOT_CONTAINS_TOKEN\_»." enum: - BETWEEN - CONTAINS_TOKEN - EQ - GT - GTE - HAS_PROPERTY - IN - LT - LTE - NEQ - NOT_CONTAINS_TOKEN - NOT_HAS_PROPERTY - NOT_IN propertyName: type: string description: >- Le nom de la propriété à filtrer. Il s'agit d'une chaîne de caractères. value: type: string description: >- La valeur spécifique à filtrer pour la propriété donnée. Il s'agit d'une chaîne de caractères. values: type: array description: >- Un tableau de valeurs de chaîne utilisé pour le filtrage lorsque plusieurs valeurs sont applicables. items: type: string description: "Définit une condition unique pour la recherche d'objets CRM, en spécifiant la propriété sur laquelle filtrer, l'opérateur à utiliser (tel que «\_égal à\_», «\_supérieur à\_» ou «\_contient\_») et la ou les valeurs à comparer. " NextPage: required: - after type: object properties: after: type: string description: >- Un jeton de chaîne utilisé comme curseur pour récupérer la page de résultats suivante. link: type: string description: >- Une URL de chaîne qui fournit un lien direct vers la page de résultats suivante. description: >- Spécifie les informations de pagination nécessaires pour récupérer le prochain ensemble de résultats dans une réponse d'API paginée PreviousPage: required: - before type: object properties: before: type: string description: >- Un jeton de chaîne qui indique la position du dernier élément de la page précédente, utilisé pour la pagination. link: type: string description: >- Une URL de chaîne qui fournit un lien direct vers la page de résultats précédente. description: >- spécifie les informations de pagination nécessaires pour récupérer l'ensemble de résultats précédent dans une réponse d'API paginée ValueWithTimestamp: required: - sourceType - timestamp - value type: object properties: sourceId: type: string description: Une chaîne identifiant la source spécifique de la valeur. sourceLabel: type: string description: >- Une étiquette de chaîne fournissant une description lisible par un humain de la source. sourceType: type: string description: >- Une chaîne indiquant le type de source à partir de laquelle la valeur a été dérivée. Cette propriété est requise. timestamp: type: string description: >- La date et l'heure d'enregistrement de la fiche d'informations, au format ISO 8601. format: date-time updatedByUserId: type: integer description: >- L'ID de l'utilisateur ayant mis à jour la valeur en dernier, représenté sous forme d'un entier. format: int32 value: type: string description: >- La valeur associée à l'horodatage. Elle est représentée sous forme de chaîne. description: Modèle de propriété qui inclut un horodatage. PublicObjectWarning: required: - category - context - message type: object properties: category: type: string description: Une chaîne indiquant la catégorie de l'avertissement. context: type: object additionalProperties: type: string description: >- Un objet fournissant un contexte supplémentaire sur l'avertissement, avec des propriétés de chaîne. message: type: string description: Une chaîne contenant le message qui décrit l'avertissement. description: >- Représente un message d'avertissement lié à un objet public dans HubSpot, fournissant des détails sur la nature et le contexte de l'avertissement. ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- Le nom du champ ou du paramètre dans lequel l'erreur a été détectée. Il s'agit d'une propriété de type chaîne de caractères. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur 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: crm.objects.appointments.read: '' crm.objects.appointments.sensitive.read.v2: '' crm.objects.appointments.sensitive.write.v2: '' crm.objects.appointments.write: '' crm.objects.calls.read: '' crm.objects.carts.read: '' crm.objects.carts.write: '' crm.objects.commercepayments.read: '' crm.objects.commercepayments.write: '' crm.objects.companies.highly_sensitive.read.v2: '' crm.objects.companies.highly_sensitive.write.v2: '' crm.objects.companies.read: '' crm.objects.companies.sensitive.read.v2: '' crm.objects.companies.sensitive.write.v2: '' crm.objects.companies.write: '' crm.objects.contacts.highly_sensitive.read.v2: '' crm.objects.contacts.highly_sensitive.write.v2: '' crm.objects.contacts.read: '' crm.objects.contacts.sensitive.read.v2: '' crm.objects.contacts.sensitive.write.v2: '' crm.objects.contacts.write: '' crm.objects.courses.read: '' crm.objects.courses.write: '' crm.objects.custom.highly_sensitive.read.v2: '' crm.objects.custom.highly_sensitive.write.v2: '' crm.objects.custom.read: '' crm.objects.custom.sensitive.read.v2: '' crm.objects.custom.sensitive.write.v2: '' crm.objects.custom.write: '' crm.objects.deals.highly_sensitive.read.v2: '' crm.objects.deals.highly_sensitive.write.v2: '' crm.objects.deals.read: '' crm.objects.deals.sensitive.read.v2: '' crm.objects.deals.sensitive.write.v2: '' crm.objects.deals.write: '' crm.objects.emails.read: '' crm.objects.feedback_submissions.read: '' crm.objects.goals.read: '' crm.objects.goals.write: '' crm.objects.invoices.read: '' crm.objects.invoices.write: '' crm.objects.leads.read: '' crm.objects.leads.write: '' crm.objects.line_items.read: '' crm.objects.line_items.write: '' crm.objects.listings.read: '' crm.objects.listings.write: '' crm.objects.meetings.read: '' crm.objects.notes.read: '' crm.objects.orders.read: '' crm.objects.orders.write: '' crm.objects.partner-clients.read: '' crm.objects.partner-clients.write: '' crm.objects.partner-services.read: '' crm.objects.partner-services.write: '' crm.objects.products.read: '' crm.objects.products.write: '' crm.objects.projects.highly_sensitive.read: '' crm.objects.projects.highly_sensitive.write: '' crm.objects.projects.read: '' crm.objects.projects.sensitive.read: '' crm.objects.projects.sensitive.write: '' crm.objects.projects.write: '' crm.objects.quotes.read: '' crm.objects.quotes.write: '' crm.objects.services.read: '' crm.objects.services.write: '' crm.objects.subscriptions.read: '' crm.objects.subscriptions.write: '' crm.objects.tasks.read: '' crm.objects.tickets.highly_sensitive.read: '' crm.objects.tickets.highly_sensitive.write: '' crm.objects.tickets.sensitive.read: '' crm.objects.tickets.sensitive.write: '' crm.objects.users.read: '' crm.objects.users.write: '' e-commerce: '' media_bridge.read: '' tickets.highly_sensitive.v2: '' tickets.sensitive.v2: '' ````