BillyouHelp

↑↓ select · ↵ open · Esc close

Pagination

Purpose

List endpoints paginate. Two styles appear in the public reference. Check the endpoint you are calling before assuming one shape.

Page numbers

Invoices, clients, and payments take:

QueryDefaultLimits
page1minimum 1
limit20minimum 1, maximum 100

GET /api/invoices returns the page inside data.pagination:

{
  "success": true,
  "data": {
    "invoices": [],
    "pagination": { "total": 15, "page": 1, "limit": 20, "pages": 1 }
  }
}

GET /api/clients returns the clients as the data array and puts total, page, and limit in the top-level meta object.

Cursors

Webhook endpoint and delivery lists use cursors:

QueryMeaning
limitPage size. Default 10, maximum 100
starting_afterReturn items after this id
ending_beforeReturn items before this id

The response includes has_more and total_count.