Paginate lists
Paginate lists with the v2 cursor-based endpoint.
POST /v1/lists and takes the same request body and response shape.
Send an empty JSON body to return the 30 most recently updated live lists.
Filter by list ID
Usefilters, not filter, to filter list pagination results. The only supported filter is id, and it must be an array.
id is in the array. A request with more than 100 IDs is rejected with too_many_ids. Any other filter key, or a non-array id, is rejected with invalid_filter.
Page through results
Setdate to the updated value of the last list you received to fetch the next page. When ascending is true, date returns lists updated after that timestamp instead.Authorizations
Recommended authentication for new integrations. Generate a short-lived JWT from your API Secret ID and API Secret Key, then pass the signed JWT as a bearer token in the Authorization header.
API Secret credentials are available in the Heymarket app under Settings > Integrations > API. The Secret Key is shown only when it is generated, so copy and store it securely before closing the dialog.
Use the following JWT values:
Replace CURRENT_UNIX_TIMESTAMP with the current Unix timestamp in seconds when generating the token.
Sign the JWT with HMAC-SHA256 using this signing secret:
Send the signed JWT as a bearer token:
Tokens expire 5 minutes after the iat timestamp. Generate a new JWT per request, or cache it briefly for less than 5 minutes. Generate JWTs only from trusted server-side code; do not expose the API Secret Key in browser, mobile, or other client-side code.
Body
Pagination json