Serviceable locations

List the postal codes and cities Vwala can price

Changed on

Returns every Serviceable Location — each (postal code, city) pair Vwala can price — with the energy types available there. Use it to populate a postal-code/city picker, to validate a location before calling comparison or simulation, and to round-trip the city value straight into those endpoints' supply-point inputs. provides lists the priceable energy types: ELECTRICITY is present for every location, GAS only where a supported gas distribution operator exists — so a location whose provides omits GAS cannot be priced for gas. That refusal is supply-point/gas-not-available in every region, including Wallonia, whose locations are served for electricity only. Pass postalCode to narrow to a single code; several cities can share one code, so the result may hold more than one location. Each location also carries the region it belongs to; pass region to narrow to the locations that region serves, which keeps a picker from offering a location outside a region the caller has already committed to — a mismatch that would otherwise only surface as a pricing error. Both filters are optional and combine; omitting them returns every Serviceable Location. Coverage currently spans supported Fluvius locations in Flanders, Sibelga's whole Brussels-Capital Region service area, and the Walloon electricity localities served by ORES, AIEG, AIESH and REW; a location absent from this list is not serviceable and pricing it returns supply-point/location-not-serviceable. Walloon locations are electricity-only, and Walloon localities served by RESA are not yet listed. Brussels-Capital is officially bilingual, so a commune whose Dutch and French names differ is listed under both, separated by / (for example Elsene / Ixelles).

get/v1/serviceable-locations

Request

Query parameters

postalCodestring

Optional 4-digit Belgian postal code to narrow the result to that code's cities.

region'Flanders' | 'BrusselsCapitalRegion' | 'Wallonia'

Optional Belgian Region to narrow the result to the locations that region serves. Pass it when the caller has already committed to a region, so a picker cannot offer a location outside it.

Response

Default Response

Changes

    • info

      added the new optional query request parameter region

    • info

      added the non-success response with the status

    • info

      added the required property // to the response with the status