メンバーシップ

Fetch List Memberships Ordered by Added to List Date

レコードがリストに追加された時間で並べ替えられる順序でリストのメンバーシップを取得します。

「after」オフセットが指定されている場合や、オフセットが指定されていない場合、「recordId」は昇順に並べ替えられます。「before」オフセットのみが指定されている場合、レコードは降順に並べ替えられます。

両方のオフセットが指定されている場合、「before」オフセットパラメーターよりも「after」オフセットパラメーターが優先されます。

GET

crm

lists

2026-03

{listId}

memberships

join-order

リストに追加された日付で並べ替えられたリストメンバーシップを取得

curl --request GET \
  --url https://api.hubapi.com/crm/lists/2026-03/{listId}/memberships/join-order \
  --header 'Authorization: Bearer <token>'

{
  "results": [
    {
      "membershipTimestamp": "2023-11-07T05:31:56Z",
      "recordId": "<string>"
    }
  ],
  "paging": {
    "next": {
      "after": "<string>",
      "link": "<string>"
    },
    "prev": {
      "before": "<string>",
      "link": "<string>"
    }
  },
  "total": 123
}

Supported products

Required Scopes

承認

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 operation

results

object[]

必須

Show child attributes

paging

object

Show child attributes

total

integer<int64>

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

最終更新日 2026年6月5日

Retrieve lists

Fetch List Memberships Ordered by ID

⌘I