From cc74b74742b3322d69a5abcab02093a94bc288f1 Mon Sep 17 00:00:00 2001 From: Petr Malina Date: Thu, 28 Sep 2023 22:42:14 +0200 Subject: [PATCH] Document Page parameter in Vehicle listing | REL: #758 --- docs/api-basics/vehicles.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/api-basics/vehicles.md b/docs/api-basics/vehicles.md index 0eb9dd0..6fe1164 100644 --- a/docs/api-basics/vehicles.md +++ b/docs/api-basics/vehicles.md @@ -12,12 +12,19 @@ One potentially confusing part of Tesla's API is the switching use of the `id` a For the state and command APIs, you should be using the `id` field. If your JSON parser doesn't support large numbers (>32 bit), then you can use the `id_s` field for a string version of the ID. -## GET `/api/1/vehicles` +## GET `/api/1/vehicles?page={page}` Retrieve a list of your owned vehicles. +The list is limited to a maximum of 100 entries. Use the `page` GET parameter to iterate over the response page and use +the response `count` variable to determine if another request should be made. + ### Request parameters +| Field | Example | Description | Required | Default | +| :----- | :------ | :-------------- | :------- | :------ | +| `page` | `1` | The page number | no | 1 | + ### Response ```json