List endpoints for locations and tariffs 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
Results are filtered by routing rules. An eMSP only sees locations and tariffs from CPOs with active routing pairs.
Rate limits
Location list requests 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 CPOs)