Zum Hauptinhalt springen
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 -Starter
Sales HubSales Hub -無料ツール
Service HubService Hub -無料ツール
Content HubContent Hub -Starter
この API には、次のいずれかのスコープが必要です。
crm.lists.read

Authorizations

Authorization
string
header
required

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

Path Parameters

listId
string
required

リストのILS ID

Query Parameters

after
string

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

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

before
string

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

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

limit
integer
default:100

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

Response

Successful response

results
object[]
required
total
integer
paging
object

The cursor to be used for paging through records.