Pagination

Large lists (members, statement, feed, products) come in pages. You ask for a page with two parameters and get back, along with the items, the pagination block.

#The parameters

curl -s "https://api.memberfy.net/api/profiles/list?page=2&limit=50" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"

#The response

{
  "success": true,
  "message": "…",
  "data": [ { "…": "…" } ],
  "pagination": { "page": 2, "limit": 50, "total": 137, "totalPages": 3 }
}

#Walking through everything

let page = 1;
const all = [];
while (true) {
  const { data, pagination } = await api.profiles.getList({ page, limit: 100 });
  all.push(...data);
  if (page >= pagination.totalPages) break;
  page += 1;
}

#Filters and pagination

Filters (search, role, type, status…) are applied before paginating: total and totalPages only count what matches the filter.

#Tips

• Use the largest limit that makes sense (up to 100) to make fewer calls.
• Don't assume every list is paginated: when one isn't, the pagination block doesn't come back and data holds everything.
• When walking through a list that changes while you read it (the feed, for example), an item may show up on two pages; deduplicate by id.

#Related

• Responses and errors
• JavaScript SDK