List endpoints for locations, tariffs, sessions, and CDRs support offset-based pagination with OCPI Link headers.
Query parameters
| Parameter | Type | Description |
|---|---|---|
offset | integer | Number of records to skip (default: 0) |
limit | integer | Maximum records per page |
date_from | ISO 8601 | Return only records updated after this timestamp |
Example request
GET /ocpi/2.2.1/locations?offset=0&limit=50&date_from=2025-06-01T00:00:00Z
Authorization: Token {your-token}
Link header
When more results exist, the Hub includes an OCPI Link header:
Link: <https://hub.chargeindia.com/ocpi/2.2.1/locations?offset=50&limit=50>; rel="next"
Follow rel="next" links until no further page is returned.
Response envelope
{
"status_code": 1000,
"timestamp": "2025-06-23T10:00:00.000Z",
"data": [ ... ]
}
Routing filter
Locations and tariffs are filtered by routing rules. Sessions and CDRs are filtered by cdr_token ownership (only records for your eMSP party).
Rate limits
List requests for locations, sessions, and CDRs are limited to 200 requests/minute per party. See Rate Limits & Errors.
Sync strategy
Recommended approach for eMSPs:
- Initial full sync with
offset/limitpagination - Periodic incremental sync using
date_fromset to last successful sync timestamp - Handle empty pages gracefully (routing changes may reduce visible catalog rows)