> ## Documentation Index
> Fetch the complete documentation index at: https://docs.volteras.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Vehicle

> Retrieve detailed information about a vehicle by specifying its unique identifier (ID).

**Returns:**
- A response containing detailed information about the vehicle.


Possible Codes in Error Response (see [Errors](https://docs.volteras.com/api-reference/errors) for error response schema and meaning of codes):

- AUTHENTICATION_ERROR
- REQUEST_VALIDATION_ERROR
- RESOURCE_NOT_FOUND
- SERVER_ERROR



## OpenAPI

````yaml get /v1/vehicles/{vehicle_id}
openapi: 3.1.0
info:
  title: VOLTERAS CONNECT
  version: 0.1.0
servers:
  - url: https://api.volteras.com
  - url: https://api.sandbox.volteras.com
security: []
paths:
  /v1/vehicles/{vehicle_id}:
    get:
      tags:
        - Vehicles
      summary: Get Vehicle
      description: >-
        Retrieve detailed information about a vehicle by specifying its unique
        identifier (ID).


        **Returns:**

        - A response containing detailed information about the vehicle.



        Possible Codes in Error Response (see
        [Errors](https://docs.volteras.com/api-reference/errors) for error
        response schema and meaning of codes):


        - AUTHENTICATION_ERROR

        - REQUEST_VALIDATION_ERROR

        - RESOURCE_NOT_FOUND

        - SERVER_ERROR
      operationId: get_vehicle_v1_vehicles__vehicle_id__get
      parameters:
        - name: vehicle_id
          in: path
          required: true
          schema:
            type: string
            title: Vehicle ID
            description: Unique internal identifier for the vehicle.
          description: Unique internal identifier for the vehicle.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Vehicle'
      security:
        - OAuth2ClientCredentialsBearer: []
components:
  schemas:
    Vehicle:
      properties:
        make:
          type: string
          title: Make
          description: Manufacturer of the vehicle.
        model:
          anyOf:
            - type: string
            - type: 'null'
          title: Model
          description: >-
            Subcategory of the make, used to differentiate between different
            variations of a vehicle within the same make.
        trim:
          anyOf:
            - type: string
            - type: 'null'
          title: Trim
          description: >-
            Subcategory of the model, used to differentiate between different
            variations of a vehicle within the same model. Also referred to as
            version or generation.
        modelYear:
          anyOf:
            - type: string
            - type: 'null'
          title: Modelyear
          description: >-
            Year the vehicle model was released. Could be different than the
            year the vehicle was manufactured.
        vin:
          type: string
          title: Vin
          description: Vehicle identification number. Unique identifier for the vehicle.
        registrationPlate:
          anyOf:
            - type: string
            - type: 'null'
          title: Registrationplate
          description: >-
            Plate that is attached to a vehicle and displays a unique
            combination of letters and numbers assigned to the vehicle by a
            government agency. Also referred to as license plate or registration
            number.
        isRegNoValidated:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Isregnovalidated
          description: Indicates whether the registration plate has been validated
        regNoValidatedAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Regnovalidatedat
          description: Timestamp of when the registration plate was last validated
        id:
          type: string
          title: Id
          description: Unique internal identifier for the vehicle.
        metadata:
          $ref: '#/components/schemas/VehicleMetaData'
          description: Additional information about the vehicle.
        isListening:
          type: boolean
          title: Islistening
          description: >-
            Indicates whether the vehicle is currently accepting data ingestion
            and commands. Defaults to True when no listening state entries have
            been recorded.
          default: true
        listeningLastUpdated:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Listeninglastupdated
          description: >-
            UTC timestamp for the most recent listening-state update, or null
            when no entries exist.
        connectionStatus:
          anyOf:
            - type: string
            - type: 'null'
          title: Connectionstatus
          description: >-
            Connection status of the vehicle (e.g. CONNECTED,
            PENDING_CONNECTION, DISCONNECTED).
        connectionErrorCode:
          anyOf:
            - type: string
            - type: 'null'
          title: Connectionerrorcode
          description: Error code if the vehicle has a connection issue.
        connectionErrorMessage:
          anyOf:
            - type: string
            - type: 'null'
          title: Connectionerrormessage
          description: Human-readable error message for connection issues.
        actionCategory:
          anyOf:
            - type: string
            - type: 'null'
          title: Actioncategory
          description: >-
            Who must act on the connection error: CUSTOMER_ACTION,
            CONTACT_SUPPORT, or UNDER_REVIEW.
      type: object
      required:
        - make
        - vin
        - id
        - metadata
      title: Vehicle
    VehicleMetaData:
      properties:
        lastSeenAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Lastseenat
          description: >-
            The last recorded interaction with the vehicle endpoints. This is a
            timestamp in ISO 8601 format: YYYY-MM-DDThh:mm:ssTZD.
        consentId:
          anyOf:
            - type: string
            - type: 'null'
          title: Consentid
          description: >-
            Unique identifier for the consent that was used to retrieve the
            vehicle data.
        accountId:
          anyOf:
            - type: string
            - type: 'null'
          title: Accountid
          description: >-
            Unique identifier for the account that was used to retrieve the
            vehicle data.
        registrationDate:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Registrationdate
          description: >-
            Vehicle registration date (ISO 8601, day granularity). Captured at
            vehicle upload; used as the date-axis baseline for service-interval
            alerts.
      type: object
      required:
        - lastSeenAt
        - consentId
        - accountId
      title: VehicleMetaData
  securitySchemes:
    OAuth2ClientCredentialsBearer:
      type: oauth2
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /v1/oauth2/token

````