---
title: "Maintenance details of a vehicle."
method: GET
path: "/fleets/{fid}/vehicles/{vid}/maintenance"
tags: ["Vehicles"]
---

# Maintenance details of a vehicle.

`GET /fleets/{fid}/vehicles/{vid}/maintenance`

## Request

- Base URL: `https://api-cert.groupe-psa.com/connectedcar/v3`
- URL: `https://api-cert.groupe-psa.com/connectedcar/v3/fleets/{fid}/vehicles/{vid}/maintenance`
- 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/fleets/:fid/vehicles/:vid/maintenance/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the latest Maintenance information for a Vehicle.

## Path parameters

- `fid` string, required
- `vid` string, required

## Query parameters

- `profile` 'fleet' | 'endUser'

## Response `200`

Maintenant response

- Maintenance: Expresses next Maintenance details. Such as number of days and the mileage until the next Maintenance. The value is negative if the next maintenance (day or mileage) is already passed. At least one of the following maintenance information will be provided.
  - `createdAt` string, date-time, required: Date when the resource has been created.
  - `updatedAt` string, date-time: Date when the resource has been updated.
  - `vin` string, required: Identifier of a vehicle. **Set when retrieving resource in batch mode**.
  - `daysBeforeMaintenance` integer
  - `mileageBeforeMaintenance` number, float
  - `_links` object, required
    - `self` Link, required: A Link Object as defined by [JSONHAL#Link Object](https://tools.ietf.org/html/draft-kelly-json-hal-08#section-5).
      - `href` string, required: URL format follows [RFC 3986](https://tools.ietf.org/html/rfc3986) and usually looks like this ` scheme://host[:port][/Path] `
      - `templated` boolean: SHOULD be true when the Link Object's "href" property is an [URI Template](https://tools.ietf.org/html/rfc6570)
      - `type` string: a hint to indicate the media type expected when dereferencing the target resource.
      - `deprecation` string: indicates that the link is to be deprecated (i.e. removed) at a future date. Its value is a URL that SHOULD provide further information about the deprecation.
      - `name` string
      - `title` string: Its value is a string and is intended for labelling the link with a human-readable identifier (as defined by [RFC5988](https://tools.ietf.org/html/rfc5988)).
      - `profile` string: Its value is a string and is intended for indicating the language of the target resource (as defined by [RFC5988]).
      - `hreflang` string: Its value is a string which is a URI that hints about the profile (as defined by [I-D.wilde-profile-link](https://tools.ietf.org/html/draft-kelly-json-hal-08#ref-I-D.wilde-profile-link)) of the target resource.
    - `vehicle` Link: A Link Object as defined by [JSONHAL#Link Object](https://tools.ietf.org/html/draft-kelly-json-hal-08#section-5).
      - `href` string, required: URL format follows [RFC 3986](https://tools.ietf.org/html/rfc3986) and usually looks like this ` scheme://host[:port][/Path] `
      - `templated` boolean: SHOULD be true when the Link Object's "href" property is an [URI Template](https://tools.ietf.org/html/rfc6570)
      - `type` string: a hint to indicate the media type expected when dereferencing the target resource.
      - `deprecation` string: indicates that the link is to be deprecated (i.e. removed) at a future date. Its value is a URL that SHOULD provide further information about the deprecation.
      - `name` string
      - `title` string: Its value is a string and is intended for labelling the link with a human-readable identifier (as defined by [RFC5988](https://tools.ietf.org/html/rfc5988)).
      - `profile` string: Its value is a string and is intended for indicating the language of the target resource (as defined by [RFC5988]).
      - `hreflang` string: Its value is a string which is a URI that hints about the profile (as defined by [I-D.wilde-profile-link](https://tools.ietf.org/html/draft-kelly-json-hal-08#ref-I-D.wilde-profile-link)) of the target resource.
    - `alerts` Link: A Link Object as defined by [JSONHAL#Link Object](https://tools.ietf.org/html/draft-kelly-json-hal-08#section-5).
      - `href` string, required: URL format follows [RFC 3986](https://tools.ietf.org/html/rfc3986) and usually looks like this ` scheme://host[:port][/Path] `
      - `templated` boolean: SHOULD be true when the Link Object's "href" property is an [URI Template](https://tools.ietf.org/html/rfc6570)
      - `type` string: a hint to indicate the media type expected when dereferencing the target resource.
      - `deprecation` string: indicates that the link is to be deprecated (i.e. removed) at a future date. Its value is a URL that SHOULD provide further information about the deprecation.
      - `name` string
      - `title` string: Its value is a string and is intended for labelling the link with a human-readable identifier (as defined by [RFC5988](https://tools.ietf.org/html/rfc5988)).
      - `profile` string: Its value is a string and is intended for indicating the language of the target resource (as defined by [RFC5988]).
      - `hreflang` string: Its value is a string which is a URI that hints about the profile (as defined by [I-D.wilde-profile-link](https://tools.ietf.org/html/draft-kelly-json-hal-08#ref-I-D.wilde-profile-link)) of the target resource.

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