> ## Documentation Index
> Fetch the complete documentation index at: https://developer.plugchoice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Energy Suppliers

Returns the energy suppliers a household can choose in one country, in the order Plugchoice shows them. Use it to let your user pick the supplier they buy their energy from.

A country Plugchoice holds no suppliers for returns an empty list.

<ParamField query="country" type="string" required>
  The country as a two-letter ISO 3166 code, such as `NL` or `DE`. Upper or lower case.
</ParamField>

## Response

<ResponseField name="data" type="array">
  Array of energy supplier objects, in display order.

  <Expandable title="energy supplier">
    <ResponseField name="id" type="string">
      The supplier's identifier within the country, such as `vattenfall`. It stays the same over time.
    </ResponseField>

    <ResponseField name="name" type="string">
      The supplier name.
    </ResponseField>

    <ResponseField name="logo_url" type="string">
      The full URL of the supplier's logo, an SVG or PNG file. Can be `null`.
    </ResponseField>
  </Expandable>
</ResponseField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.