メインコンテンツへスキップ
GET
/
crm
/
v3
/
lists
/
{listId}
/
memberships
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
}

サポートされる製品

次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing Hub -無料ツール
Sales HubSales Hub -無料ツール
Service HubService Hub -無料ツール
Content HubContent Hub -無料ツール

承認

​
Authorization
string
header
必須

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

パスパラメータ

​
listId
string
必須

リストのILS ID。

クエリパラメータ

​
after
string

前にリクエストしたレコードの「後」にくるページのページング オフセット トークン。

指定されている場合、レスポンスのレコードがオフセット後のレコードになり、昇順で並べ替えられます。「before」オフセットよりも優先されます。

​
before
string

前にリクエストしたレコードの「前」にくるページのページング オフセット トークン。

指定されている場合、レスポンスのレコードがオフセット前のレコードになり、降順で並べ替えられます。

​
limit
integer<int32>
デフォルト:100

レスポンスで返されるレコードの数。「上限」は250件です。

レスポンス

Successful response

​
results
object[]
必須
​
paging
object

The cursor to be used for paging through records.

​
total
integer<int64>

クエリーに一致するレコードの合計数。

Last modified on March 30, 2026