---
title: "Vehicle's stolen position."
method: GET
path: "/fleets/{fid}/vehicles/{vid}/stolen/{sid}/waypoints"
tags: ["Vehicles"]
---

# Vehicle's stolen position.

`GET /fleets/{fid}/vehicles/{vid}/stolen/{sid}/waypoints`

## Request

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

Returns position information about a specific stolen context for a vehicle.

## Path parameters

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

## Response `200`

Stolen position response.

- WayPoints
  - `_links` TabLinks, required: [HAL](https://en.wikipedia.org/wiki/Hypertext_Application_Language#Convention) (Hypertext Application Language) link collection
    - `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.
    - `first` 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.
    - `next` 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.
    - `prev` 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.
    - `last` 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.
  - `total` integer, required
  - `totalPage` integer, required
  - `currentPage` integer, required
  - `_embedded` object, required
    - `positions` Position[], required
      - `type` 'Feature', required
      - `geometry` Point, required: This object expresses a GeoJSON Point as specified by [rfc7946](https://tools.ietf.org/html/rfc7946#section-3.1.2).
        - `coordinates` number[], required: This is a simple 2 (or more) numbers vector used to define Geometry Point objects.
        - `type` 'Point', required
      - `properties` object, required
        - `createdAt` string, date-time, required: Date when the resource has been created.
        - `vin` string: Identifier of a vehicle. **Set when retrieving resource in batch mode**.
        - `heading` integer: Course angle expressed in degree.
        - `signalQuality` integer
        - `type` 'Estimated' | 'Acquire'
        - `fixStatus` '2D' | '3D': Fix status information is only returned when position type is set to Acquire. Horizontal & altitude position can be determined in 3D fix status mode where it is only horizontal position in 2D mode.

## Other responses

- `default`: wayPoints not found

---

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