---
title: "List of vehicles characteristics & capabilities"
method: GET
path: "/vehicles/{vin}"
tags: ["Capabilities"]
---

# List of vehicles characteristics & capabilities

`GET /vehicles/{vin}`

## Request

- Base URL: `https://api-cert.groupe-psa.com/connectedcar/v3`
- URL: `https://api-cert.groupe-psa.com/connectedcar/v3/vehicles/{vin}`
- Auth: HTTP basic and API key in query parameter `client_id`
- TypeScript: <https://skmtc.dev/groupe-psa/apis/groupe-psa-connected-car-b2b-api/docs/vehicles/:vin/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns vehicle'scharacteristics & capabilities

## Path parameters

- `vin` string, required

## Query parameters

- `locale` string
- `extension` string[]

## Response `200`

OK

- VehicleCapabilities
  - `vin` string, required: Serial number of a vehicle
  - `motorization` 'Electric' | 'Hybrid' | 'Thermic' | 'Hydrogen': Motorization of the vehicle.
  - `_embedded` object
    - `extension` VehicleExtension: Additional vehicle information.
      - `onboardCapabilities` OnboardCapabilities
        - `data` string[]: List of retrievable data represented by their scopes.
        - `remote` object: List of callable remote functions and associated supported properties.
          - `preconditioning` object, required
            - `supported` boolean, required: true means remote preconditioning is supported.
            - `scopeName` 'remote:preconditioning:write', required
            - `parameters` object, required
              - …
          - `charging` object, required
            - `supported` boolean, required: true means remote charging is supported.
            - `scopeName` 'remote:charging:write', required
            - `parameters` object, required
              - …
          - `door` object, required
            - `supported` boolean, required: true means remote door is supported.
            - `scopeName` 'remote:door:write', required
          - `horn` object, required
            - `supported` boolean, required: true means remote horn is supported.
            - `scopeName` 'remote:horn:write', required
          - `lights` object, required
            - `supported` boolean, required: true means remote lights is supported.
            - `scopeName` 'remote:lights:write', required
          - `wakeup` object, required
            - `supported` boolean, required: true means remote wakeup is supported.
            - `scopeName` 'remote:wakeup:write', required
          - `navigation` object, required
            - `supported` boolean, required: true means remote navigation is supported.
            - `scopeName` 'remote:navigation:write', required
          - `stolen` object, required
            - `supported` boolean: True means remote navigation is supported.
      - `branding` VehicleBranding
        - `brand` string: Brand of a vehicle
        - `label` string: Car model description.
      - `pictures` Url[]: Link to a vehicle picture.

## Other responses

- `default` (unresolved $ref)

---

[API](https://skmtc.dev/groupe-psa/apis/groupe-psa-connected-car-b2b-api.md) - [All operations](https://skmtc.dev/groupe-psa/apis/groupe-psa-connected-car-b2b-api/llms.txt) - [OpenAPI document](https://skmtc.dev/groupe-psa/apis/groupe-psa-connected-car-b2b-api/revisions/023ff3e3fe51?raw)
