# Initiate vehicle onboarding

Initiate the onboarding process for a new vehicle in your user's browser (or an embedded web view in an app).

If none of make_id, model_id or trim_id are passed as query parameters, the user will be shown a user interface to pick their vehicle make.

Endpoint: GET /vehicle_onboarding
Version: 2.0
Security: 

## Query parameters:

  - `user_id` (string, required)
    The ID of a user to onboard a device for.
    Example: "user01HN2NJ9NMRZBXT1H6FT9N7735"

  - `make_id` (string)
    Specify the make of vehicle to be onboarded.
    Example: "vmak01J443798BF893ZHFQVCS0FA23"

  - `model_id` (string)
    Specify the model of vehicle to be onboarded.
    Example: "vhcl01HNARS42AVJN9QWQF6J52B7MB"

  - `trim_id` (string)
    Specify the trim of vehicle to be onboarded.
    Example: "vhcl01HNARS42AVJN9QWQF6J52B7MB"

  - `client_id` (string, required)
    Your client ID, used to identify GET requests made in a user's browser.
    Example: "sandbox-cc-id"

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