---
title: "Get user electricity contracts"
method: GET
path: "/users/{userId}/electricity-contracts"
tags: ["Contracts|Electricity"]
---

# Get user electricity contracts

`GET /users/{userId}/electricity-contracts`

## Request

- Base URL: `https://connect.clever.gy`
- URL: `https://connect.clever.gy/users/{userId}/electricity-contracts`
- Auth: API key in header `clevergy-api-key`

Retrieves the details of the user electricity contracts

## Path parameters

- `userId` string, required

## Response `200`

Successful retrieval of electricity contracts

- ElectricityContract[]
  - `id` string, required: Unique identifier of the electricity contract
  - `startDate` string, date, required: Start date of the electricity contract
  - `endDate` string, date: End date of the electricity contract
  - `status` 'ACTIVE' | 'INACTIVE', required: Status of the electricity contract
  - `address` string, required: Address associated with the electricity contract
  - `postalCode` string: Postal code associated with the electricity contract
  - `connectionId` string: UUID of the electricity connection
  - `connectionContractId` string: ID of the connection contract
  - `cups` string, required: Universal Point of Supply Code (CUPS)
  - `importTariffType` 'FIXED' | 'PVPC' | 'INDEXED' | 'PERIOD' | 'CUSTOM', required: Import tariff access code
  - `surplusTariffType` 'FIXED' | 'PVPC' | 'INDEXED' | 'PERIOD' | 'CUSTOM': Surplus tariff access code
  - `tariffAccess` '2.0TD' | '3.0TD' | '6.1TD', required: Tariff access code
  - `tariffName` string, required: Name of the tariff applied to the contract
  - `iban` string: IBAN for billing purposes
  - `distributorName` string: Name of the electricity distributor company
  - `holderName` string: Name of the contract holder
  - `commercialName` string: Name of the commercial electricity company
  - `contractPower` number[], required: Contracted power for each period (kW). The array should contain up to 6 periods.
  - `powerPrices` number[]: Power prices for each period (€/kW). The array should contain up to 6 periods.
  - `energyPrices` number[]: Energy prices for each period (€/kWh). The array should contain up to 6 periods.
  - `surplusPrices` number[]: Surplus prices for each period (€/kWh). The array should contain up to 6 periods.
  - `fileUrl` string, required: URL to access the electricity contract file. Also used to upload a new contract file as response in POST and PUT methods.
  - `contractNumber` string: Contract number

## Other responses

- `401`: Unauthorized
- `404`: User not found
- `default`: Unexpected error

---

[API](https://skmtc.dev/clevergy/apis/clevergy-connect-api.md) - [All operations](https://skmtc.dev/clevergy/apis/clevergy-connect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clevergy/apis/clevergy-connect-api/revisions/d333c5eecb5b?raw)