# Retrieve user

Retrieve information about a single, specific user.

Endpoint: GET /users/{user_id}
Version: 2.0
Security: oauth2

## Security:

  - `oauth2` (unknown)
    oauth2 scopes: user:read

## Path parameters:

  - `user_id` (string, required)
    The ID of the specific user to retrieve.

## Query parameters:

  - `expand` (array)
    Specify a url field to expand into a nested resource.

  - `include_deleted` (boolean)
    Include users whose account has been deleted. Deleted users are omitted by default, and addressing one by ID returns 404 unless this is set. Has no effect on the `me` alias, which always resolves to the caller's own user. Send `true` or `false`; an empty value counts as absent. Other spellings, such as `1` or `0`, will be rejected with an `invalid-query-parameter-value` problem.

## Header parameters:

  - `EvEnergy-Version` (number)
    Specify the version of this endpoint to use.

## Response 200:

  - `200` (unknown)
    Returns a single User.

## Response 200 fields (application/json):

  - `verification_status` (string | null)
    The user's verification status in the program of the enrollment behind `enrollment_status`: the status of their latest verification record, or `UNVERIFIED` if they have none. Null if that program does not verify its users, or if the user has never enrolled in one of your programs.
    Enum: "UNVERIFIED", "LEFT_PROGRAM", "PENDING", "PENDING_USER", "PENDING_REVIEW", "VERIFIED", "REJECTED", "null"

  - `utility_accounts` (array)
    The identifiers of the user's utility accounts in your programs, newest account first. An account can carry both an account number and a service agreement ID, which appear as two entries. Empty if the user has no utility account in one of your programs.

  - `utility_accounts.type` (string, required)
    What kind of identifier `value` is, an account number or a service agreement ID.
    Enum: "ACCOUNT_NUMBER", "SERVICE_AGREEMENT_ID"

  - `utility_accounts.value` (string, required)
    The identifier the utility uses for the account.
    Example: 0000123456

  - `phone` (string | null)
    The user's phone number. Null if they have not given one, and always null once the user is deleted.
    Example: +447700900123

  - `id` (string, required)
    Unique identifier for the given user.
    Example: user01HN2NJ9NMRZBXT1H6FT9N7735

  - `url` (string, required)
    Example: https://api.ev.energy/v2/users/user01HN2NJ9NMRZBXT1H6FT9N7735

  - `email` (string)

  - `full_name` (string)
    The user's full name.
    Example: Frodo Baggins

  - `joined_at` (string)
    The date and time when the user joined the platform.
    Example: 2023-06-15T10:00:00Z

  - `terms_consent_datetime` (string | null)
    When the user gave their terms and conditions consent, or null if they have not.
    Example: 2023-06-15T10:00:00Z

  - `deleted_at` (string | null)
    When the user's account was deleted, or null if it is still live. Deleted accounts are anonymised, so the remaining fields hold placeholder values rather than the user's data, except `enrollment_status`, `tier_enrolled_at` and `left_at`, which keep their real enrollment history. Reaching a deleted user requires `include_deleted=true`.
    Example: 2024-08-01T12:00:00Z

  - `referral_code` (string | null)
    This user's personal referral code.
    Example: FRODO1

  - `referral_performance` (object)
    How the users who signed up with this user's referral code have progressed,
broken down by stage like a promo code's `performance`. `rewarded_count` counts
referrals this user has been credited for, whether or not the credit has been
paid out yet. `qualified_count` ignores the referral scheme's membership, region
and active-window rules and any cap on the referrer's rewards, so it can be
higher than `rewarded_count`.

  - `referral_performance.redeemed_count` (integer, required)
    Users who signed up with this user's referral code.
    Example: 3

  - `referral_performance.qualified_count` (integer, required)
    Of those, the users who have finished a charging session of at least 1 kWh.
    Example: 2

  - `referral_performance.in_progress_count` (integer, required)
    `redeemed_count` minus `qualified_count`, clamped at zero.
    Example: 1

  - `referral_performance.rewarded_count` (integer, required)
    Referrals this user has been credited for with a value above zero.
    Example: 1

  - `deleted` (boolean)
    Whether the user's account has been deleted. True exactly when `deleted_at` is set.
    Example: false

  - `enrollment_status` (string | null)
    The user's standing in your programs: `ENROLLED` while they hold an open enrollment in one of them, `LEFT` once their latest enrollment has ended, or null if they have never enrolled in any of them.
    Enum: "ENROLLED", "LEFT", "null"

  - `tier_enrolled_at` (string | null)
    When the enrollment behind `enrollment_status` began, or null if the user has never enrolled in one of your programs.
    Example: 2024-01-10T14:30:00Z

  - `left_at` (string | null)
    When the enrollment behind `enrollment_status` ended, or null while it is open or if the user has never enrolled in one of your programs.
    Example: null

  - `program` (any)
    The program of the enrollment behind `enrollment_status`, or null if the user has never enrolled in one of your programs. Defaults to a url, but can be expanded to the full Program resource via the `expand` query parameter.

  - `program.id` (string)
    Example: prog01JCK1HPNAANB8WN253G27SFPC

  - `program.url` (string)
    Example: https://api.ev.energy/v2/programs/prog01JCK1HPNAANB8WN253G27SFPC

  - `program.name` (string)
    A human-friendly name for the Program.
    Example: CoolCharge

  - `program.description` (string)
    A plain text description of the program's incentives and requirements.
    Example: A program which incentivises charging when it's coolest to charge your EV

  - `program.logo` (string | null)
    URL to download a logo image for the Program.

  - `program.sponsor_name` (string)
    The name of the organisation which sponsors the program. Often, but not always, a utility company.
    Example: Cool Power

  - `program.external_url` (string)
    A publicly accessible URL where individuals can enroll in the program.
    Example: https://www.example.com/coolcharge

  - `program.sign_up_url` (string | null)
    URL of the registration form for this specific program, where one exists.
    Example: https://www.example.com/coolcharge/sign-up

  - `program.eligibility_criteria` (string | null)
    HTML description of who is eligible to join the program.
    Example: <html><p>Residential customers of Cool Power with a compatible EV or home charger.</p></html>

  - `program.benefits` (string | null)
    HTML description of the benefits of joining the program.
    Example: <html><p>Earn a monthly bill credit for charging off-peak.</p></html>

  - `program.country` (string)
    ISO 3166-1 alpha-2 code of the country the program operates in.
    Example: US

  - `program.faqs_url` (string | null)
    URL of the program's FAQ page, where one exists.
    Example: https://www.example.com/coolcharge/faqs

  - `program.support_email` (string)
    Customer support email address for this program.
    Example: support@ev.energy

  - `program.payment_frequency` (string | null)
    How often incentive payments are made, where the program pays incentives.
    Enum: "WEEKLY", "MONTHLY", "QUARTERLY", "null"

  - `program.payment_day_of_month` (integer | null)
    Day of the month incentive payments are made, for monthly or quarterly programs. 31 means the last day of the month. Null when the program has no payment day configured.
    Example: 15

  - `program.payment_weekday` (string | null)
    Day of the week incentive payments are made, for weekly programs. Null when the program has no payment weekday configured.
    Enum: "MON", "TUE", "WED", "THU", "FRI", "SAT", "SUN", "null"

  - `program.hidden` (boolean)
    Whether the program is hidden from public program lists. Hidden programs (test, internal, ended or mothballed) are omitted from the list endpoint for anonymous and driver-scoped requests, but are still returned by ID and are always listed for organisation-scoped API clients.
    Example: false

  - `tier` (any)
    The tier of the enrollment behind `enrollment_status`, or null if the user has never enrolled in one of your programs. Defaults to a url, but can be expanded to the full ProgramTier resource via the `expand` query parameter. A hidden tier is still linked, and still embedded when expanded, but its url returns 404. An expanded tier's `eligible` describes the requesting user (or the driver acted as via `EvEnergy-User`), not necessarily this user.

  - `tier.id` (string)
    Example: tier01JCK1HPNAANB8WN253G27SFPC

  - `tier.url` (string)
    Example: https://api.ev.energy/v2/programs/prog01JCK1HPNAANB8WN253G27SFPC/tiers/tier01JCK1HPNAANB8WN253G27SFPC

  - `tier.short_name` (string)
    A short slug-style identifier for the tier, unique within a program.
    Example: standard

  - `tier.name` (string | null)
    A human-friendly name for the tier.
    Example: Standard Tier

  - `tier.logo_svg` (string | null)
    URL to download an SVG logo for the tier.

  - `tier.description_short` (string | null)
    Short HTML description of the tier. Wrapped in `<html>` tags on both real and sandbox responses.

  - `tier.description_long` (string | null)
    Longer HTML description of the tier. Wrapped in `<html>` tags on both real and sandbox responses.

  - `tier.smart_charging_enabled` (boolean)
    Whether smart charging is enabled for users in this tier.

  - `tier.disable_changing_tariff` (boolean)
    Whether users in this tier are blocked from changing their tariff.

  - `tier.visible` (boolean)
    Whether this tier should be shown to users when selecting a tier within the program.

  - `tier.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). A Clerk active-organisation
session acting as a driver via `EvEnergy-User` gets that driver's eligibility.
`null` for anonymous and pure client-credentials requests.

  - `default_location` (any)
    LocationDetail is served when a single user is requested, otherwise Location is served for user lists.

  - `default_location.address_1` (string | null)
    First line of address.

  - `default_location.address_2` (string | null)
    Second line of address.

  - `default_location.postal_code` (string | null)
    Postal Code.

  - `default_location.country_code` (string)
    ISO 3166-1 2 letter Country Codes.
    Enum: "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW"

  - `default_location.coordinates` (any)

  - `default_location.coordinates.latitude` (number, required)
    Example: 51.52576576674041

  - `default_location.coordinates.longitude` (number, required)
    Example: -0.08366433371722264

  - `default_location.tariff` (any)
    The import tariff at this location. When updating, it must be a tariff visible to you: a public tariff or one of your organisation's custom tariffs. Renders as `null` if the tariff is another organisation's custom tariff.

  - `default_location.tariff.id` (string, required)
    Unique identifier for the given user.
    Example: tari01HN2NJ9NMRZBXT1H6FT9N7735

  - `default_location.tariff.url` (string, required)
    Example: https://api.ev.energy/v2/tariffs/tari01HN2NJ9NMRZBXT1H6FT9N7735

  - `default_location.tariff.supplier` (any, required)
    The energy company that supplies this tariff.

  - `default_location.tariff.supplier.id` (string, required)
    Unique identifier for the given user.
    Example: supl01HN2NJ9NMRZBXT1H6FT9N7735

  - `default_location.tariff.supplier.url` (string, required)
    Example: https://api.ev.energy/v2/suppliers/supl01HN2NJ9NMRZBXT1H6FT9N7735

  - `default_location.tariff.supplier.name` (string, required)
    Example: Rivendell Renewables

  - `default_location.tariff.supplier.icon` (string | null, required)
    Example: https://cdn.example.com/rivendell_renewables.jpg

  - `default_location.tariff.supplier.highlighted` (boolean)
    A highlighted supplier is one that is often selected by users.

  - `default_location.tariff.name` (string, required)
    Example: Fangorn Biomass

  - `default_location.tariff.currency` (string, required)
    Example: GBP

  - `default_location.tariff.highlighted` (boolean)
    A highlighted tariff is one that is often selected by users.

  - `default_location.tariff.type` (string)
    Enum: "FLAT_RATE", "DUAL_RATE", "THREE_RATE", "DYNAMIC", "EXTERNALLY_MANAGED", "OTHER"

  - `default_location.tariff.daily_prices` (object)
    Information about the tariff's prices for different parts of the day.

  - `default_location.tariff.daily_prices.peak` (object, required)
    A single price for a certain time range.

  - `default_location.tariff.daily_prices.peak.price` (string | null)
    The price is in major currency units e.g. 0.10 means £0.10. `null` for licensed tariffs without the tariff:prices:read scope.
    Example: 0.10

  - `default_location.tariff.daily_prices.peak.times` (array)

  - `default_location.tariff.daily_prices.peak.times.start` (string)
    Example: 18:00:00

  - `default_location.tariff.daily_prices.peak.times.end` (string)
    Example: 00:00:00

  - `default_location.tariff.timezone_name` (string)
    Example: Europe/London

  - `default_location.tariff.price_chart_url` (string | null)
    The url of a website which can display a chart of prices for the tariff. This website is an external resource and is not affiliated with ev.energy.
    Example: https://www.example.com/

  - `default_location.tariff.prices_include_vat` (boolean | null)
    Whether the prices of this tariff include VAT. `null` if this is not known for the tariff.
    Example: true

  - `default_location.tariff.gsp_group` (string | null)
    The GB Grid Supply Point (DNO region) the tariff applies to. Suppliers publish region-specific rates, so the same named tariff can appear once per region with differing prices; this field distinguishes them. `null` for tariffs that are not region-specific.
    Example: _C

  - `default_location.tariff.valid_from` (string)
    The date from which this tariff became available to new customers.
    Example: 2026-03-17

  - `default_location.tariff.valid_until` (string | null)
    The date after which this tariff is no longer available to new customers (it has been superseded). `null` if the tariff is still open to new sign-ups. Use the `valid` query parameter to filter the list to only currently-available tariffs.
    Example: 2027-03-17

  - `default_location.tariff.payment_method` (string | null)
    The payment method the tariff's prices apply to. Some suppliers charge different rates depending on how the customer pays, so the same named tariff can appear once per payment method; this field distinguishes them. `null` when the supplier does not price by payment method.
    Enum: "DIRECT_DEBIT", "NON_DIRECT_DEBIT", "null"

  - `default_location.tariff.scheduler_tariff` (any)
    The tariff used by the scheduler for charge optimisation, which may differ from the billing tariff. Returns a URL by default, or null if not set. Expandable with ?expand=scheduler_tariff to return a TariffBase object (additional fields may be present beyond those listed here).

  - `default_location.tariff.scheduler_tariff.id` (string, required)

  - `default_location.tariff.scheduler_tariff.url` (string, required)

  - `default_location.tariff.scheduler_tariff.supplier` (string, required)

  - `default_location.tariff.scheduler_tariff.name` (string, required)

  - `default_location.tariff.scheduler_tariff.currency` (string, required)

  - `default_location.city` (string | null)

  - `default_location.state` (string | null)

  - `default_location.evse_site` (any)
    If null, the user's location is not an EVSE Site. Otherwise, this field references the site they are a part of.

  - `default_location.evse_site.id` (string, required)

  - `default_location.evse_site.url` (string, required)
    Example: https://api.ev.energy/v2/evse_sites/site01JX2SZ0WAFTDYVYY0JRAYREY7

  - `default_location.evse_site.evses` (array, required)
    A list of all EVSEs that are currently associated with this site.

  - `default_location.evse_site.cpms_connection` (string | null, required)
    The type of ChargePoint Management System that this site is connected to, if there is one.
    Enum: "null", "CHARGEPOINT", "SWTCH"

  - `default_location.evse_site.cpms_connection_display_name` (string | null)
    A human-readable name for the Chargepoint Management System that the site is connected to.
    Example: ChargePoint

  - `default_location.evse_site.user_connected` (boolean | null)
    When authenticated as a specific user (eg. via the Authorisation Code grant type) or when the EvEnergy-User header is set to a valid user ID, this field will indicate whether the user is currently connected to this EVSE Site's CPMS. If the request is not made in the context of a user, or the site does not have a CPMS connection, this field will be null.

  - `default_location.current_carbon_intensity_grams_per_kilowatt_hour` (integer | null)
    The current carbon intensity associated with the location in gCO2/kWh.
    Example: 300

  - `vehicles` (array)

  - `evses` (array)

## Response 200 headers (application/json):

  - `EvEnergy-Version` (number)
    Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.
    Enum: "2"

  - `X-RateLimit-Limit` (number)
    The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

  - `X-RateLimit-Remaining` (number)
    The number of requests remaining until this client's rate limit is reached.

  - `RetryAfter` (number)
    The number of seconds until this client's requests will not be rate limited.

## Response 400:

  - `400` (unknown)
    A problem with the request's parameters prevented it being fulfilled. This endpoint rejects query parameters it does not read, and values it cannot parse.

## 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 400 headers (application/problem+json):

  - `EvEnergy-Version` (number)
    Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.
    Enum: "2"

  - `X-RateLimit-Limit` (number)
    The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

  - `X-RateLimit-Remaining` (number)
    The number of requests remaining until this client's rate limit is reached.

## Response 401:

  - `401` (unknown)
    You need to authorise requests to access this resource.

## 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 401 headers (application/problem+json):

  - `EvEnergy-Version` (number)
    Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.
    Enum: "2"

  - `X-RateLimit-Limit` (number)
    The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

  - `X-RateLimit-Remaining` (number)
    The number of requests remaining until this client's rate limit is reached.

  - `RetryAfter` (number)
    The number of seconds until this client's requests will not be rate limited.

## Response 403:

  - `403` (unknown)
    You do not have permission to perform this action.

## Response 403 fields (application/problem+json):

  - `status` (number)
    Example: 403

  - `title` (string, required)
    Example: Forbidden

  - `detail` (string, required)
    Example: You do not have permission to perform this action.

## Response 403 headers (application/problem+json):

  - `EvEnergy-Version` (number)
    Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.
    Enum: "2"

  - `X-RateLimit-Limit` (number)
    The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

  - `X-RateLimit-Remaining` (number)
    The number of requests remaining until this client's rate limit is reached.

  - `RetryAfter` (number)
    The number of seconds until this client's requests will not be rate limited.

## Response 404:

  - `404` (unknown)
    This resource either does not exist or the client is not authorized to access it.

## 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 404 headers (application/problem+json):

  - `EvEnergy-Version` (number)
    Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.
    Enum: "2"

  - `X-RateLimit-Limit` (number)
    The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

  - `X-RateLimit-Remaining` (number)
    The number of requests remaining until this client's rate limit is reached.

  - `RetryAfter` (number)
    The number of seconds until this client's requests will not be rate limited.

## Response 406:

  - `406` (unknown)
    Could not satisfy the request Accept header.

## 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 406 headers (application/problem+json):

  - `EvEnergy-Version` (number)
    Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.
    Enum: "2"

  - `X-RateLimit-Limit` (number)
    The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

  - `X-RateLimit-Remaining` (number)
    The number of requests remaining until this client's rate limit is reached.

  - `RetryAfter` (number)
    The number of seconds until this client's requests will not be rate limited.

## Response 429:

  - `429` (unknown)
    The client has exceeded its rate limit.

## 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

## Response 429 headers (application/problem+json):

  - `EvEnergy-Version` (number)
    Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.
    Enum: "2"

  - `Retry-After` (number)
    The number of seconds until this client's requests will not be rate limited.

  - `X-RateLimit-Limit` (number)
    The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

  - `X-RateLimit-Remaining` (number)
    The number of requests remaining until this client's rate limit is reached.

## Response 400 examples:

  - `Unsupported Version` (unknown)

  - `Unknown Query Parameter` (unknown)

  - `Invalid Query Parameter Value` (unknown)

## Response 429 examples:

  - `Example 1` (unknown)