JouloDocs
Api referenceEnergy

List your locations

Every address where Joulo books charging for you: postcode, city and country per location. The street and house number are never returned. Requires the locations:read scope, which is separate from profile:read so you allow it on its own.

GET
/locations

Authorization

AuthorizationBearer <token>

API token from the Joulo dashboard, or an OAuth2 access token.

In: header

Response Body

curl -X GET "https://api.joulo.nl/functions/v1/api/locations"
{
  "locations": [
    {
      "id": "0b7e2c4a-1f3d-4a5b-9c6d-7e8f9a0b1c2d",
      "postal_code": "1234AB",
      "city": "Utrecht",
      "country": "NL"
    },
    {
      "id": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f",
      "postal_code": "4321ZX",
      "city": "Breda",
      "country": "NL"
    }
  ]
}
{
  "error": "Missing or invalid API token"
}
{
  "error": "Insufficient scope",
  "required_scope": "chargers:read"
}