# List program tiers List all selectable tiers under the given Program. Public read-only — no authentication required. When the request is authenticated as a specific user (Authorization Code grant, or Client Credentials with `EvEnergy-User`), each tier's `eligible` field is populated with the user's eligibility result. Anonymous or pure client-credentials requests receive `eligible: null`. Endpoint: GET /programs/{program_id}/tiers Version: 2.0 Security: oauth2 ## Path parameters: - `program_id` (string, required) The ID of the specific Program to retrieve. ## Query parameters: - `page_before` (string) Return results from the page after this ID. - `page_after` (string) Return results from the page before this ID. - `page_size` (integer) Specify the number of results to return per page. ## Header parameters: - `EvEnergy-Version` (number) Specify the version of this endpoint to use. - `EvEnergy-User` (string) If the client is authenticated using Client Credentials, setting EvEnergy-User to a valid user ID allows requests to be made as if you were directly authenticated as that user. ## Response 200 fields (application/json): - `id` (string) Example: tier01JCK1HPNAANB8WN253G27SFPC - `url` (string) Example: https://api.ev.energy/v2/programs/prog01JCK1HPNAANB8WN253G27SFPC/tiers/tier01JCK1HPNAANB8WN253G27SFPC - `short_name` (string) A short slug-style identifier for the tier, unique within a program. Example: standard - `name` (string | null) A human-friendly name for the tier. Example: Standard Tier - `logo_svg` (string | null) URL to download an SVG logo for the tier. - `description_short` (string | null) Short HTML description of the tier. Wrapped in `` tags on both real and sandbox responses. - `description_long` (string | null) Longer HTML description of the tier. Wrapped in `` tags on both real and sandbox responses. - `smart_charging_enabled` (boolean) Whether smart charging is enabled for users in this tier. - `disable_changing_tariff` (boolean) Whether users in this tier are blocked from changing their tariff. - `visible` (boolean) Whether this tier should be shown to users when selecting a tier within the program. - `eligible` (boolean | null) Whether the authenticated user is eligible to join this tier. Populated only when the request is authenticated as a specific user (Authorization Code / Password grant, or Client Credentials with the `EvEnergy-User` header). `null` for anonymous and pure client-credentials requests. ## Response 400 fields (application/problem+json): - `type` (string) Example: https://api.ev.energy/v2/problems/example-problem/ - `status` (number) Example: 400 - `title` (string, required) Example: Short description - `detail` (string, required) Example: Long, more specific description. - `instance` (string) Example: https://api.ev.energy/v2/users/user01HN2P75GBNFRJPCZJXEFVXH5E - `notification` (object) Something that the user should be informed about. - `notification.id` (string, required) Unique identifier for the Notification Example: notf67O36PLTFDB57M0E5L33JZLGM0 - `notification.url` (string, required) Example: https://api.ev.energy/notifications/notf67O36PLTFDB57M0E5L33JZLGM0 - `notification.message_id` (string, required) Internal identifier for this notification type. E.g. 'ERR0023' - `notification.category` (string, required) Category of this notification type Enum: "ACTIONABLE", "SERVICE", "RETRY", "MARKETING", "INTERNAL" - `notification.event_time` (string, required) The timestamp of the event described by this notification - `notification.short_text_title` (string, required) Short title for the notification - `notification.short_text_body` (string, required) Short description of the event being notified - `notification.detail_page_title` (string, required) Title of a help page giving more information about this notification - `notification.detail_page_body` (string, required) Text of a help page giving more information about this notification - `notification.external_link` (string | null, required) URL of a web page giving further information about this notification - `notification.external_button_label` (string, required) Text to be displayed on a button leading to the external_link location - `notification.read_at` (string) When the user examined the contents of this notification - `notification.resolved_at` (string) When the problem associated with this notification was resolved ## Response 401 fields (application/problem+json): - `status` (number) Example: 401 - `title` (string, required) Example: Unauthorized - `detail` (string, required) Example: Authentication credentials were not provided. ## Response 404 fields (application/problem+json): - `status` (number) Example: 404 - `title` (string, required) Example: Not found - `detail` (string, required) Example: Resource does not exist or cannot be accessed. ## Response 406 fields (application/problem+json): - `status` (number) Example: 406 - `title` (string, required) Example: Not Acceptable - `detail` (string, required) Example: Could not satisfy the request Accept header. ## Response 429 fields (application/problem+json): - `type` (string) Example: https://api.ev.energy/v2/problems/example-problem/ - `status` (number) Example: 400 - `title` (string, required) Example: Short description - `detail` (string, required) Example: Long, more specific description. - `instance` (string) Example: https://api.ev.energy/v2/users/user01HN2P75GBNFRJPCZJXEFVXH5E - `notification` (object) Something that the user should be informed about. - `notification.id` (string, required) Unique identifier for the Notification Example: notf67O36PLTFDB57M0E5L33JZLGM0 - `notification.url` (string, required) Example: https://api.ev.energy/notifications/notf67O36PLTFDB57M0E5L33JZLGM0 - `notification.message_id` (string, required) Internal identifier for this notification type. E.g. 'ERR0023' - `notification.category` (string, required) Category of this notification type Enum: "ACTIONABLE", "SERVICE", "RETRY", "MARKETING", "INTERNAL" - `notification.event_time` (string, required) The timestamp of the event described by this notification - `notification.short_text_title` (string, required) Short title for the notification - `notification.short_text_body` (string, required) Short description of the event being notified - `notification.detail_page_title` (string, required) Title of a help page giving more information about this notification - `notification.detail_page_body` (string, required) Text of a help page giving more information about this notification - `notification.external_link` (string | null, required) URL of a web page giving further information about this notification - `notification.external_button_label` (string, required) Text to be displayed on a button leading to the external_link location - `notification.read_at` (string) When the user examined the contents of this notification - `notification.resolved_at` (string) When the problem associated with this notification was resolved