---
title: "Get all energy merchants"
method: GET
path: "/v1/merchants"
tags: ["Energy catalog"]
---

# Get all energy merchants

`GET /v1/merchants`

## Query parameters

- `offset` number
- `limit` number

## Response `200`

Default Response

- object
  - `data` MerchantWithUsps[], required
    - `id` string, uuid, required — Unique identifier (UUID) for the merchant
    - `canonicalName` string, required — Stable identifier derived from the merchant's display name (camelCase, e.g. "engie" or "boltEnergie"). Unique per merchant.
    - `displayName` string, required — The merchant's display name
    - `website` string, uri, nullable, required — Merchant website URL
    - `hasNativeApp` boolean, nullable, required — Whether the merchant offers a native mobile app
    - `cooperative` boolean, nullable, required — Whether the merchant is a cooperative
    - `automatedSwitch` boolean, required — Whether Vwala can switch to this merchant automatically via an API integration (i.e. the merchant is an integration partner), rather than a manual or redirect submission.
    - `vregServicecheckRating` integer, nullable, required — VREG servicecheck rating, from 1 to 5 stars.
    - `vregComplaintsPerThousand` number, nullable, required — VREG complaints per 1000 customers.
    - `country` string, required — ISO 3166-1 alpha-2 country code (e.g. BE)
    - `usps` object[], required — Unique selling points (marketing highlights).
      - `label` string, required
      - `description` string, nullable, required
  - `meta` object, required
    - `offset` number, required
    - `limit` number, required
    - `total` number, required

---

[API](https://skmtc.net/vwala/apis/energy-platform-api.md) · [All operations](https://skmtc.net/vwala/apis/energy-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vwala/energy-platform-api/versions/bd3eb35109f9/schema)