---
title: "Get a merchant by id"
method: GET
path: "/v1/merchants/{id}"
tags: ["Energy catalog"]
---

# Get a merchant by id

`GET /v1/merchants/{id}`

## Path parameters

- `id` string, uuid, required

## Response `200`

Default Response

- MerchantWithUsps
  - `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

## Other responses

- `404` — Default Response

---

[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/revisions/bd3eb35109f9/schema)