API Reference

Batch locations

get
https://{environment}.plugsurfing.com/drive/v1/locations/batch

Retrieve locations in batches. Locations are returned sorted by last_updated timestamp in ascending order. Prices are not included, to get prices for a given location, use Get location by id. Best practices:

  1. Perform initial FULL PULL by paginating through all locations
  2. Perform regular DELTA PULLS using last_updated parameter to get only updated locations
  3. Use the last_updated value of the last location in the last page as the starting point for next DELTA PULL
  4. Perform periodic FULL PULLS to detect removed locations
  5. Use cursor to resume interrupted pulls
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
number
10 to 500
Defaults to 50

Optional - used to set page size value

string

Optional - pass cursor from previous response body to get next page.

string

Optional - when set, only locations updated after this date are returned. example 2024-05-27T10:44:48Z.

string

Optional - when set, only locations in these countries are returned. example DEU or DEU,FRA.

string

Optional - when set, only locations having at least one connector with this power_type are returned. possible values: AC or DC.

Responses

Updated about 2 months ago

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago