---
title: "Retrieve join order"
method: GET
path: "/crm/lists/2026-09/{listId}/memberships/join-order"
tags: ["Basic"]
---

# Retrieve join order

`GET /crm/lists/2026-09/{listId}/memberships/join-order`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/lists/2026-09/{listId}/memberships/join-order`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.segments.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.lists.read`

Retrieve the join order of memberships for a specific list in your HubSpot account. This endpoint allows you to view the order in which records joined the list, which can be useful for tracking membership changes over time.

## Path parameters

- `listId` string, required

## Query parameters

- `after` string
- `before` string
- `limit` integer

## Response `200`

successful operation

- ApiCollectionResponseJoinTimeAndRecordId
  - `paging` Paging: Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: A string token used as a cursor to retrieve the next page of results. It is returned as the `paging.next.after` JSON property in a paged response.
      - `link` string: A URL string that provides a direct link to the next page of results.
    - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required: A string token used to identify the position in the list before the current page, enabling navigation to the previous page.
      - `link` string: A URL string that provides a direct link to the previous page of results.
  - `results` JoinTimeAndRecordId[], required: An array of objects, each containing join time and record ID information.
    - `membershipTimestamp` string, date-time, required: The timestamp indicating when the record was added to the list. It is represented as a string in date-time format.
    - `recordId` string, required: The unique identifier for the record within the list. It is represented as a string.
  - `total` integer: An integer representing the total number of results available.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-10** (2026-09) `e1dd745172d1`: 2 info
  - the security scope `crm.segments.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-07** (2026-09) `6d0e6dc36ca0`: 2 info
  - the security scope `crm.segments.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.read` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/crm-lists/changes/crm/lists/2026-09/:listId/memberships/join-order/get.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-lists.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-lists/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-lists/revisions/e1dd745172d1?raw)