> ## 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. # Batch read memberships > Récupérer les informations de contrôle d'accès par lot pour les fiches d'informations au sein de listes spécifiées. Ce point de terminaison est utile pour obtenir les détails de contrôle d'accès en masse, permettant une récupération efficace des données lors du traitement de plusieurs fiches d'informations. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/crm-lists-v2026-09.json POST /crm/lists/2026-09/records/memberships/batch/read 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/records/memberships/batch/read: post: tags: - Batch summary: Lire les contrôles d'accès par lot description: >- Récupérer les informations de contrôle d'accès par lot pour les fiches d'informations au sein de listes spécifiées. Ce point de terminaison est utile pour obtenir les détails de contrôle d'accès en masse, permettant une récupération efficace des données lors du traitement de plusieurs fiches d'informations. operationId: post-/crm/lists/2026-09/records/memberships/batch/read parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/BatchInputRecordIdInput' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/BatchResponseRecordIdWithMemberships' '207': description: multiple statuses content: application/json: schema: $ref: >- #/components/schemas/BatchResponseRecordIdWithMembershipsWithErrors default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.segments.read - oauth2: - crm.lists.read components: schemas: BatchInputRecordIdInput: required: - inputs type: object properties: inputs: type: array description: >- Un tableau d'entrées d'ID de fiche d'informations. Chaque élément est une chaîne représentant un ID de fiche d'informations unique à traiter dans l'opération par lots. items: $ref: '#/components/schemas/RecordIdInput' BatchResponseRecordIdWithMemberships: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été effectuée, au format ISO 8601. format: date-time links: type: object additionalProperties: type: string description: >- Un objet contenant des liens supplémentaires liés à l'opération de lot. requestedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été demandée, au format ISO 8601. format: date-time results: type: array description: >- Un tableau de résultats de l'opération par lot, chacun contenant les ID et leurs contrôles d'accès associés. items: $ref: '#/components/schemas/RecordIdWithMemberships' startedAt: type: string description: >- La date et l'heure de début de l'opération par lot, au format ISO 8601. format: date-time status: type: string description: "Le statut actuel de l'opération par lot. Les valeurs valides incluent «\_PENDING\_», «\_PROCESSING\_», «\_CANCELED\_» et «\_COMPLETE\_»." enum: - CANCELED - COMPLETE - PENDING - PROCESSING BatchResponseRecordIdWithMembershipsWithErrors: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- La date et l'heure auxquelles le processus par lots a été effectué, au format ISO 8601. format: date-time errors: type: array description: >- Un tableau d'erreurs survenues pendant le processus par lots. Chaque élément du tableau est une référence à un schéma d'erreur standard. items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: >- Un objet contenant des liens supplémentaires liés au processus par lots. Chaque paire clé-valeur représente un nom de lien et son URL. numErrors: type: integer description: >- Le nombre total d'erreurs rencontrées au cours du processus de traitement par lots. format: int32 requestedAt: type: string description: >- La date et l'heure auxquelles le processus par lot a été demandé, au format ISO 8601. format: date-time results: type: array description: >- Un tableau de résultats contenant les ID de fiches avec leurs contrôles d'accès. Chaque élément du tableau est une référence à un schéma RecordIdWithMemberships. items: $ref: '#/components/schemas/RecordIdWithMemberships' startedAt: type: string description: >- La date et l'heure de début du processus par lot, au format ISO 8601. format: date-time status: type: string description: "Le statut actuel du processus par lot. Les valeurs valides incluent «\_PENDING\_», «\_PROCESSING\_», «\_CANCELED\_» et «\_COMPLETE\_»." enum: - CANCELED - COMPLETE - PENDING - PROCESSING RecordIdInput: required: - objectTypeId - recordId type: object properties: objectTypeId: type: string description: >- Une chaîne représentant l'identifiant unique du type d'objet associé à la fiche d'informations. recordId: type: string description: Une chaîne représentant l'identifiant unique de l'enregistrement. RecordIdWithMemberships: required: - objectTypeId - recordId - recordListMemberships type: object properties: objectTypeId: type: string description: >- L'identifiant du type d'objet auquel la fiche d'informations appartient, représenté sous forme de chaîne de caractères. recordId: type: string description: >- L'identifiant unique de la fiche d'informations, représenté sous forme de chaîne de caractères. recordListMemberships: type: array description: >- Un tableau d'adhésions indiquant les listes dont la fiche d'informations fait partie, chacune contenant des détails tels que l'ID de la liste, la version et les horodatages de l'ajout de la fiche d'informations. items: $ref: '#/components/schemas/RecordListMembership' StandardError: required: - category - context - errors - links - message - status type: object properties: category: type: string description: Une chaîne indiquant la catégorie générale de l'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 vers des tableaux de chaînes. errors: type: array description: >- Un tableau d'objets ErrorDetail qui fournissent des détails plus spécifiques sur les erreurs individuelles. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: Chaîne qui identifie de manière unique l'instance d'erreur. links: type: object additionalProperties: type: string description: >- Un objet contenant des liens connexes, représenté comme une carte de chaînes vers des chaînes. message: type: string description: Chaîne contenant une explication de l'erreur lisible par un humain. status: type: string description: Chaîne représentant le code de statut HTTP associé à l'erreur. subCategory: type: object properties: {} description: Un objet fournissant une catégorisation supplémentaire de l'erreur. description: Ye olde error 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 RecordListMembership: required: - firstAddedTimestamp - lastAddedTimestamp - listId - listVersion type: object properties: firstAddedTimestamp: type: string description: >- La date et l'heure auxquelles la fiche d'informations a été ajoutée pour la première fois à la liste, au format ISO 8601. format: date-time isPublicList: type: boolean description: Un booléen indiquant si la liste est publique. lastAddedTimestamp: type: string description: >- La date et l'heure de la dernière addition de la fiche à la liste, au format ISO 8601. format: date-time listId: type: string description: >- L'identifiant unique de la liste. Il s'agit d'une valeur de type chaîne. listVersion: type: integer description: Le numéro de version de la liste, représenté par un entier. format: int32 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: '' ````