Saltar al contenido principal
GET
/
crm
/
v3
/
lists
/
{listId}
/
memberships
Obtener membresías de lista ordenadas por ID
curl --request GET \
  --url https://api.hubapi.com/crm/v3/lists/{listId}/memberships \
  --header 'Authorization: Bearer <token>'
{
  "paging": {
    "next": {
      "after": "AAAAAAAAAS0%3D",
      "link": "https://private.hubapi.com/crm/v3/lists/123/memberships?portalId=865747473&limit=2&after=AAAAAAAAAS0%3D"
    },
    "prev": {
      "before": "AAAAAAAAAMk%3D",
      "link": "https://private.hubapi.com/crm/v3/lists/123/memberships?before=AAAAAAAAAMk%3D&portalId=865747473&limit=2"
    }
  },
  "results": [
    {
      "membershipTimestamp": "2023-11-07T16:46:04.122Z",
      "recordId": "202"
    },
    {
      "membershipTimestamp": "2023-11-07T16:46:04.122Z",
      "recordId": "232"
    },
    {
      "membershipTimestamp": "2023-11-07T16:46:04.122Z",
      "recordId": "239"
    }
  ],
  "total": 330
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

Autorizaciones

Authorization
string
header
requerido

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

Parámetros de ruta

listId
string
requerido

El ID de ILS de la lista.

Parámetros de consulta

after
string

El token de desplazamiento de paginación para la página que viene "después" de los registros solicitados previamente.

Si se especifica, entonces los registros incluidos en la respuesta serán los registros que siguen al desplazamiento, ordenados en orden ascendente. Tiene prioridad sobre el desplazamiento "antes".

before
string

El token de desplazamiento de paginación para la página que viene "antes" de los registros solicitados previamente.

Si se especifica, entonces los registros incluidos en la respuesta serán los registros que preceden al desplazamiento, ordenados en orden descendente.

limit
integer<int32>
predeterminado:100

El número de registros que se devolverá en la respuesta. El "límite" máximo es 250.

Respuesta

Successful response

results
object[]
requerido
paging
object

The cursor to be used for paging through records.

total
integer<int64>

El número total de registros que coinciden con la consulta.

Last modified on March 30, 2026