Skip to main content

Pagination

List endpoints return paginated results. Use page and limit query parameters to control the response.

Parameters

ParameterTypeDefaultDescription
pageinteger1Page number (1-indexed)
limitinteger20Items per page (max: 100)

Example

curl -X GET "https://api.nevatal.com/api/v1/patients?page=2&limit=10" \
  -H "Authorization: Bearer nvtl_your_api_key"

Response format

All paginated responses include a pagination object:
{
  "data": [...],
  "pagination": {
    "page": 2,
    "limit": 10,
    "total": 142,
    "totalPages": 15
  }
}

Best practices

  • Use reasonable page sizes (10-50 items) for most use cases
  • Cache responses when possible to reduce API calls
  • Use the total field to build pagination UI or detect when you’ve fetched everything