---
title: "List available suppliers"
method: GET
path: "/v1/suppliers"
tags: ["Supplier Integration"]
---

# List available suppliers

`GET /v1/suppliers`

Retrieves a list of all available energy suppliers that can be integrated with

## Query parameters

- `type` 'BUSINESS' | 'RESIDENTIAL'

## Response `200`

List of suppliers retrieved successfully

- Supplier[]
  - `id` string — Unique identifier for the supplier
  - `name` string — Display name of the supplier
  - `icon` string, uri — URL to the supplier's logo

## Other responses

- `4XX` — Client error response

## Changes

- **2025-12-09** `d899129585db` — 3 breaking
  - the response property `items/icon` became optional for the status `200`
  - the response property `items/id` became optional for the status `200`
  - the response property `items/name` became optional for the status `200`
- **2025-11-17** `1ecbbc9bbafb` — 3 info
  - the response property `items/icon` became required for the status `200`
  - the response property `items/id` became required for the status `200`
  - the response property `items/name` became required for the status `200`

[Change history](https://skmtc.dev/voltview/apis/voltview-api/changes/v1/suppliers/get.md)

---

[API](https://skmtc.dev/voltview/apis/voltview-api.md) · [All operations](https://skmtc.dev/voltview/apis/voltview-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/voltview/voltview-api/revisions/d90c739b55df/schema)