# List API error logs for a vehicle

List the historical API error logs for a specific Vehicle. These logs capture errors that occurred when attempting to communicate with the vehicle's telematics API.

Endpoint: GET /vehicles/{vehicle_id}/error_logs
Version: 2.0
Security: oauth2

## Path parameters:

  - `vehicle_id` (string, required)
    The ID of the specific vehicle to retrieve.
    Example: "vhcl01HRFF3SEVSCRAV9B3CHVDFN0H"

## Header parameters:

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

## Query parameters:

  - `page_before` (string)
    Return results from the page after this ID.
    Example: "xmpl01HNFZM7Q8FXASZXYZ6XM3TQRR"

  - `page_after` (string)
    Return results from the page before this ID.
    Example: "xmpl01HNFZM7Q8FXASZXYZ6XM3TQRR"

  - `page_size` (integer)
    Specify the number of results to return per page.
    Example: 10

  - `logged_at__gte` (string)
    Filters for logs logged at or after this datetime.
    Example: "2024-04-17T09:39:45.984584Z"

  - `logged_at__lte` (string)
    Filters for logs logged at or before this datetime.
    Example: "2024-04-17T09:39:45.984584Z"

  - `expand` (array)
    Specify a url field to expand into a nested resource.
    Enum: "vehicle", "vehicle.trim", "vehicle.trim.model", "vehicle.trim.model.make", "vehicle.user"

## Response 200 fields (application/json):

  - `url` (string)
    Example: "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H/error_logs/2024-04-17T09:39:45.984584Z/"

  - `logged_at` (string)
    The date and time when this error was logged by the ev.energy system.

  - `vehicle` (any)

  - `status_code` (integer)
    The HTTP status code of the error response from the vehicle telematics API.
    Example: 401

  - `controller` (string)
    The vehicle controller/integration that was being used when the error occurred.
    Example: "ENODE"

  - `error_code` (string)
    The error code received from the provider or determined by the ev.energy system.
    Example: "AUTHENTICATION_ERROR"

  - `error_type` (string)
    The error type received from the provider or determined by the ev.energy system.
    Example: "VehicleAPIUnauthorized"

  - `request_id` (string)
    The request ID that resulted in this error. Used for tracing and debugging.
    Example: "56rst-z2jku-tty9t-0dn2f-qazow"

  - `command` (string)
    The command/method that was being executed when the error occurred.
    Example: "START_CHARGE"

  - `error_detail` (string)
    Detailed information about the error.

  - `internal_command_id` (string,null)
    Internal UUID to track the command dispatch. This can be used to correlate errors with commands.
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

## 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` (any, 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)
    Title of a help page giving more information about this notification

  - `notification.detail_page_body` (string)
    Text of a help page giving more information about this notification

  - `notification.external_link` (string,null)
    URL of a web page giving further information about this notification

  - `notification.external_button_label` (string)
    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 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 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` (any, 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)
    Title of a help page giving more information about this notification

  - `notification.detail_page_body` (string)
    Text of a help page giving more information about this notification

  - `notification.external_link` (string,null)
    URL of a web page giving further information about this notification

  - `notification.external_button_label` (string)
    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