Pagination & Filtering

All list endpoints in the Strictly API support pagination and filtering via query parameters. Understanding these parameters helps you avoid timeouts, retrieve complete datasets, and build efficient integrations.

Default behavior

If you omit pagination parameters, the API returns the first 10 records. For most production use cases you will want to control this explicitly.

Pagination parameters

Get first 50 records
curl "https://api.paywithzero.net/v1/public/plan?limit=50" \
  -H "Authorization: Basic $(echo -n '[email protected]:yourpassword' | base64)" \
  -H "key-hash: YOUR_KEY_HASH"

Get page 2 (records 11–20 at default limit)
curl "https://api.paywithzero.net/v1/public/plan?page=2" \
  -H "Authorization: Basic $(echo -n '[email protected]:yourpassword' | base64)" \
  -H "key-hash: YOUR_KEY_HASH"

Get page 3 with 25 records per page
curl "https://api.paywithzero.net/v1/public/plan?page=3&limit=25" \
  -H "Authorization: Basic $(echo -n '[email protected]:yourpassword' | base64)" \
  -H "key-hash: YOUR_KEY_HASH"

Sorting

Use the sort parameter to control result order. Prefix the field name with - for descending order (most recent first):

Most recent transactions first
curl "https://api.paywithzero.net/v1/public/transactions?sort=-transactions.transactionAt" \
  -H "Authorization: Basic $(echo -n '[email protected]:yourpassword' | base64)" \
  -H "key-hash: YOUR_KEY_HASH"

Date range filtering

Many endpoints accept startDay and endDay to filter records by a time window.

Format

Both parameters use ISO 8601 format: YYYY-MM-DDTHH:mm:ss.SSSZ

Timezone parameter

The timezone parameter adjusts filtering to a named timezone so you don't have to manually calculate UTC offsets:

Code
curl "https://api.paywithzero.net/v1/public/transactions?timezone=America/New_York" \
  -H "Authorization: Basic $(echo -n '[email protected]:yourpassword' | base64)" \
  -H "key-hash: YOUR_KEY_HASH"

Accepted values follow the IANA timezone database, for example:

• America/New_York
• America/Chicago
• America/Los_Angeles
• America/Denver
• UTC

Full example

This request retrieves the 10 most recent transactions within a 3-day window, sorted by date, in Eastern Time:

cURL
curl "https://api.paywithzero.net/v1/public/transactions\
?page=1\
&limit=10\
&sort=-transactions.transactionAt\
&startDay=2025-03-03T05:00:00.000Z\
&endDay=2025-03-06T04:59:59.999Z\
&timezone=America/New_York" \
  -H "Authorization: Basic $(echo -n '[email protected]:yourpassword' | base64)" \
  -H "key-hash: YOUR_KEY_HASH"

JavaScript
const params = new URLSearchParams({
  page: "1",
  limit: "10",
  sort: "-transactions.transactionAt",
  startDay: "2025-03-03T05:00:00.000Z",
  endDay: "2025-03-06T04:59:59.999Z",
  timezone: "America/New_York",
});

const response = await fetch(
  `https://api.paywithzero.net/v1/public/transactions?${params}`,
  {
    headers: {
      Authorization: `Basic ${btoa("[email protected]:yourpassword")}`,
      "key-hash": "YOUR_KEY_HASH",
    },
  }
);

const { data } = await response.json();

Best practices

• Always set page and limit explicitly to prevent silent data truncation at 10 records
• Sort by date descending (sort=-transactions.transactionAt) to get recent records first when building dashboards or activity feeds
• Use timezone instead of manually converting UTC offsets — it's less error-prone
• Page through all results in batch jobs rather than raising limit to extreme values, which can cause timeouts on large datasets

Which endpoints support pagination?

Pagination (page, limit, sort) is supported on all list (GET) endpoints, including:

• GET /public/customer
• GET /public/transactions
• GET /public/plan
• GET /public/subscription
• GET /public/invoice
• GET /public/payment-link
• GET /public/report/pivot

Date range filtering (startDay, endDay, timezone) is supported on transaction and report endpoints. See the API Reference for the full parameter list per endpoint.