List the postal codes and cities Vwala can price
Changed onReturns 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).
Request
- Base URLhttps://open-energie.api.vwala.be
- AuthAPI key in header x-api-key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Optional 4-digit Belgian postal code to narrow the result to that code's cities.
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
queryrequest parameterregion - info
added the non-success response with the status
- info
added the required property
//to the response with the status
- info