Skip to content
Last updated

Pagination

List endpoints support limit/offset pagination to efficiently handle large datasets.

Parameters

ParameterTypeDefaultDescription
limitinteger100Maximum number of records to return per page
offsetinteger0Number of records to skip before starting to return results

How It Works

  • Page 1: offset=0, limit=100 → Returns records 1-100
  • Page 2: offset=100, limit=100 → Returns records 101-200
  • Page 3: offset=200, limit=100 → Returns records 201-300

Example

# First page (default)
curl "https://api.dualentry.com/v1/invoices" \
  -H "X-API-KEY: your_api_key_here"

# Custom page size
curl "https://api.dualentry.com/v1/invoices?limit=50&offset=100" \
  -H "X-API-KEY: your_api_key_here"

Response Format

List endpoints return an array of resources:

[
  {
    "id": "inv_001",
    "customer": "Customer A",
    "total": 1500.00
  },
  {
    "id": "inv_002",
    "customer": "Customer B",
    "total": 2300.00
  }
]

Fetching All Records

Continue fetching pages until you receive an empty array or fewer records than requested:

all_records = []
offset = 0
limit = 100

while True:
    response = requests.get(
        "https://api.dualentry.com/v1/invoices",
        headers=headers,
        params={"limit": limit, "offset": offset}
    )
    
    records = response.json()
    if not records:
        break
    
    all_records.extend(records)
    
    if len(records) < limit:
        break
    
    offset += limit

Best Practice: When fetching all records, add delays between requests to respect rate limits.

Next: Learn about Errors →

Previous page
Next page