Builder APIConcepts
Paging and limits
How long lists come in pages, and how much one call may ask for.
Long lists come in pages, and each call has limits; a call over a limit tells you how to split it.
Paging
- Pass
nextCursorback until it isnull:resources.list,points.list,meters.list,points.raw. - Pass
offsetwhilehasMoreis true:buildings.list. truncated: true(resources.related) means the result was cut: narrow the filters.
Limits per call
| Function | Limits |
|---|---|
points.timeseries (v2) | up to 1000 points; 15m buckets up to 62 days, others up to 400 days; points × buckets up to 50 000 |
points.summary | up to 500 points, up to 380 days |
points.raw (v2) | up to 200 points, up to 31 days, paged |
consumption.buildings | up to 200 buildings; hour buckets up to 62 days, others up to 1100 days; buildings × carriers × buckets up to 50 000 |
consumption.meters | up to 10 000 meters; hour buckets up to 62 days, others up to 400; meters × days up to 20 000 |
Split long ranges into several calls instead of working around a limit. Limits per caller are in Errors and limits.