---
title: "List Utility Accounts"
method: GET
path: "/utility_accounts"
tags: ["Utility Accounts"]
---

# List Utility Accounts

`GET /utility_accounts`

Returns a paginated list of UtilityAccounts for all users, or filtered by `client_user_id`. Default ordered by descending `updated_at`.

## Query parameters

- `client_user_id` string
- `limit` integer
- `updated_after` string, date-time
- `updated_before` string, date-time
- `order` 'asc' | 'desc'

## Headers

- `Arcadia-Version` string, required

## Response `200`

Success

- PaginatedUtilityAccounts
  - `data` UtilityAccount[], required
    - `id` integer, required
    - `client_user_id` string, required
    - `utility_name` string, required — The list of supported Arcadia utilities can be found [here](https://arc.arcadia.com/coverage?first=25&page=1).
    - `utility_long_name` string, required — Provides greater detail than `utility_name`. The list of supported Arcadia utilities can be found [here](https://arc.arcadia.com/coverage?first=25&page=1).
    - `utility_credential_id` integer, required
    - `account_number` string, nullable, required — The account number used by the utility to identify this UtilityAccount
    - `service_address_street_one` string, nullable, required
    - `service_address_street_two` string, nullable, required
    - `service_address_city` string, nullable, required
    - `service_address_state` string, nullable, required
    - `service_address_zip` string, nullable, required
    - `service_customer_name` string, nullable, required
    - `supplier_account_id` string, nullable, required — Utility specific account identifier for energy suppliers.
    - `status` 'active' | 'closed' | 'incomplete' | 'locked' | 'unknown', nullable, required
    - `most_recent_tariff` MostRecentTariff, required — The most recent Tariff seen on this utility account.
      - `main_tariff_id` string, required — The Genability 'masterTariffId' unique identifier for this tariff. See [Genability documentation](https://developer.genability.com/api-reference/tariff-api/tariff/) for details.
      - `property_inputs` object[] — Properties applied to this tariff which may affect the calculated cost of electricity.
        - `id` string, required
        - `value` union, required
          - boolean
          - number
          - string
      - `supplier_name` string, nullable — The name of the retail electricity supplier or the community choice aggregator. If there is no retail electricity supplier or community choice aggregator, this field is null.
      - `tariff_code` string, required — Abbreviation code of the tariff used for this calculation.
      - `tariff_name` string, required — Full name of the tariff used for this calculation.
      - `utility_name` string, required — Name of the utility associated with this tariff
      - `tariff_as_of_date` string, date, nullable, required — The statement date of the utility statement that reported use of this tariff.
    - `flags` string[], required
    - `services` string[], required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `feature_availability` FeatureAvailability, required
      - `charge_cost` 'AVAILABLE' | 'NOT_AVAILABLE' | 'NOT_READY', required
      - `smart_charge` 'AVAILABLE' | 'NOT_AVAILABLE' | 'NOT_READY', required
      - `utility_statements` 'AVAILABLE' | 'NOT_AVAILABLE' | 'NOT_READY', required
      - `hosted_payments` 'AVAILABLE' | 'NOT_AVAILABLE' | 'NOT_READY', required
      - `utility_remittance` 'AVAILABLE' | 'NOT_AVAILABLE' | 'NOT_READY', required
    - `utility_meters` UtilityMeter[], required
      - `id` integer, required
      - `client_user_id` string, required
      - `utility_credential_id` integer, required
      - `utility_account_id` integer, required
      - `meter_number` string, required
      - `service_type` 'electric' | 'gas' | 'water', required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `sandboxed` boolean, required
    - `sandboxed` boolean, required
  - `total_count` integer, required

---

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