# Pagination and windows

Part of the InboxWA API reference: https://inboxwa.online/docs/api . Full reference as one document: https://inboxwa.online/docs/api.md . OpenAPI: https://inboxwa.online/openapi.json

Lists return `data` and a `next_cursor`. To get the next page, pass `next_cursor` back as `cursor`. Treat it as opaque. A `null` cursor means the last page. `limit` is 1 to 200; each endpoint states its default.

List endpoints look at a window of time rather than all history, so one call cannot scan years of chats. `since` and `to` accept an ISO 8601 timestamp or a date. Defaults and maximum spans are stated per endpoint: 30 days for chat lists, 7 days for replies, metrics and failed messages. The window is echoed back in the response.

**Walking every page**

```bash
cursor=""
while :; do
  page=$(curl -s "https://inboxwa.online/api/reporting/v1/conversations?limit=200&unread=true${cursor:+&cursor=$cursor}" \
    -H "Authorization: Bearer $INBOXWA_KEY")
  echo "$page" | jq -c '.data[]'
  cursor=$(echo "$page" | jq -r '.next_cursor // empty')
  [ -z "$cursor" ] && break
done
```