> ## 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.

# List memberships

> Récupérer les contrôles d'accès d'une liste spécifique dans votre compte HubSpot. Ce point de terminaison vous permet de parcourir les contrôles d'accès à la liste à l'aide d'une pagination basée sur un curseur. Il est utile pour obtenir des informations détaillées sur les contrôles d'accès d'une liste donnée.

> **Supported products**

> **Required Scopes**


## OpenAPI

````yaml specs/2026-09/crm-lists-v2026-09.json GET /crm/lists/2026-09/{listId}/memberships
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/{listId}/memberships:
    get:
      tags:
        - Basic
      summary: Inscriptions à une liste
      description: >-
        Récupérer les contrôles d'accès d'une liste spécifique dans votre compte
        HubSpot. Ce point de terminaison vous permet de parcourir les contrôles
        d'accès à la liste à l'aide d'une pagination basée sur un curseur. Il
        est utile pour obtenir des informations détaillées sur les contrôles
        d'accès d'une liste donnée.
      operationId: get-/crm/lists/2026-09/{listId}/memberships
      parameters:
        - name: listId
          in: path
          description: >-
            L'identifiant unique de la liste dont les contrôles d'accès doivent
            être récupérés.
          required: true
          style: simple
          explode: false
          schema:
            type: string
        - name: after
          in: query
          description: >-
            Un jeton de curseur pour la pagination. Utilisez la valeur du champ
            paging.next.after de la réponse précédente pour récupérer le
            prochain ensemble de résultats.
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: before
          in: query
          description: >-
            Un jeton de curseur pour la pagination. Utilisez-le pour récupérer
            l'ensemble de résultats précédent.
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: limit
          in: query
          description: "Le nombre maximal de résultats à afficher par page\_: la valeur par défaut est 100."
          required: false
          style: form
          explode: true
          schema:
            type: integer
            format: int32
            default: 100
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiCollectionResponseJoinTimeAndRecordId'
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - crm.segments.read
        - oauth2:
            - crm.lists.read
components:
  schemas:
    ApiCollectionResponseJoinTimeAndRecordId:
      required:
        - results
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/Paging'
        results:
          type: array
          description: >-
            Un tableau d'objets, chacun contenant des informations sur l'heure
            de jonction et l'ID de fiche d'informations.
          items:
            $ref: '#/components/schemas/JoinTimeAndRecordId'
        total:
          type: integer
          description: Un entier représentant le nombre total de résultats disponibles.
          format: int64
    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.
    JoinTimeAndRecordId:
      required:
        - membershipTimestamp
        - recordId
      type: object
      properties:
        membershipTimestamp:
          type: string
          description: >-
            L'horodatage indiquant quand la fiche d'informations a été ajoutée à
            la liste. Il est représenté sous forme de chaîne de caractères au
            format date-heure.
          format: date-time
        recordId:
          type: string
          description: >-
            L'identifiant unique de la fiche d'informations au sein de la liste.
            Il est 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
    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. Il est renvoyé en tant que propriété JSON «\_paging.next.after\_» dans une réponse paginée."
        link:
          type: string
          description: >-
            Une chaîne d'URL qui fournit un lien direct vers la page de
            résultats suivante.
      description: >-
        Specifies the paging information needed to retrieve the next set of
        results in a paginated API response
    PreviousPage:
      required:
        - before
      type: object
      properties:
        before:
          type: string
          description: >-
            Un jeton de chaîne utilisé pour identifier la position dans la liste
            avant la page actuelle, permettant la navigation vers la page
            précédente.
        link:
          type: string
          description: >-
            Une chaîne d'URL qui fournit un lien direct vers la page de
            résultats précédente.
      description: >-
        specifies the paging information needed to retrieve the previous set of
        results in a paginated API response
    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: ''

````