---
updatedAt: 2026-08-10T12:21:58.000Z
agentTools:
  projectIndex: https://monta-partner-api.readme.io/llms.txt
---

# Retrieve a list of vehicle models

Required scope: `vehicles:read`

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Monta API",
    "description": "\n             see https://docs.partner-api.monta.com\n             ",
    "contact": {
      "name": "Monta API Support",
      "url": "https://www.monta.com/uk/contact",
      "email": "partner-api@monta.com"
    },
    "version": "v1"
  },
  "servers": [
    {
      "url": "https://partner-api.monta.com",
      "description": "Production"
    }
  ],
  "security": [],
  "tags": [
    {
      "name": "Vehicles"
    }
  ],
  "paths": {
    "/api/v1/vehicles/models": {
      "get": {
        "tags": [
          "Vehicles"
        ],
        "summary": "Retrieve a list of vehicle models",
        "description": "Required scope: `vehicles:read`",
        "operationId": "get-vehicle-models",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Page number to retrieve (starts with 0)",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            },
            "example": 1
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Number of items per page (between 1 and 100, default 10)",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 10
            },
            "example": 10
          },
          {
            "name": "ownerId",
            "in": "query",
            "schema": {
              "type": "integer",
              "description": "Filter to retrieve vehicles with specified team ID or user ID defined by ownerType",
              "format": "int64",
              "example": 13
            }
          },
          {
            "name": "ownerType",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Filter by owner type of the vehicle",
              "example": "team",
              "enum": [
                "team",
                "user"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of vehicle models matching the criteria",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OffsetBasedResponse_69"
                }
              }
            }
          },
          "400": {
            "description": "The request is invalid",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "example": {
                    "status": "BAD_REQUEST",
                    "message": "Invalid request",
                    "errorCode": "BAD_REQUEST"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Consumer with provided credentials was not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "example": {
                    "status": "UNAUTHORIZED",
                    "message": "Consumer with given `clientId` and `clientSecret` not found",
                    "errorCode": "CONSUMER_NOT_FOUND"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Operator doesn't have access to resource",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "example": {
                    "status": "FORBIDDEN",
                    "message": "Operator doesn't have access to resource",
                    "errorCode": "ACCESS_FORBIDDEN"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Entity with the provided id was not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "example": {
                    "status": "NOT_FOUND",
                    "message": "Requested entity/entity provided in body was not found",
                    "readableMessage": "user friendly message",
                    "errorCode": "RESOURCE_NOT_FOUND",
                    "context": "context"
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAccessToken": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "MontaPage.Meta": {
        "required": [
          "currentPage",
          "itemCount",
          "perPage",
          "totalItemCount",
          "totalPageCount"
        ],
        "type": "object",
        "properties": {
          "itemCount": {
            "type": "integer",
            "format": "int32"
          },
          "currentPage": {
            "type": "integer",
            "format": "int32"
          },
          "perPage": {
            "type": "integer",
            "format": "int32"
          },
          "totalPageCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalItemCount": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "OffsetBasedResponse_69": {
        "required": [
          "data",
          "meta"
        ],
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VehicleModel"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/MontaPage.Meta"
          }
        }
      },
      "VehicleBrand": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id of the vehicle brand",
            "format": "int64",
            "example": 1
          },
          "name": {
            "type": "string",
            "description": "Name of the vehicle brand",
            "example": "Tesla"
          },
          "logoUrl": {
            "type": "string",
            "description": "URL of the brand logo",
            "nullable": true,
            "example": "https://imgix.monta.com/brands/tesla.png"
          },
          "integrationStatus": {
            "type": "string",
            "description": "Integration status of the brand. Null if no integration available, otherwise SUPPORTED or BETA",
            "nullable": true,
            "example": "SUPPORTED"
          }
        }
      },
      "VehicleConnector": {
        "required": [
          "name",
          "slug"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id of the vehicle connector",
            "format": "int64",
            "example": 1
          },
          "name": {
            "type": "string",
            "description": "Name of the vehicle connector",
            "example": "Type 2"
          },
          "slug": {
            "type": "string",
            "description": "Slug of the vehicle connector",
            "example": "type2"
          }
        }
      },
      "VehicleModel": {
        "required": [
          "brand",
          "connectors",
          "displayName",
          "model"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id of the vehicle model",
            "format": "int64",
            "example": 1
          },
          "brand": {
            "description": "Brand of the vehicle model",
            "allOf": [
              {
                "$ref": "#/components/schemas/VehicleBrand"
              }
            ]
          },
          "model": {
            "type": "string",
            "description": "Model name",
            "example": "Model 3"
          },
          "variant": {
            "type": "string",
            "description": "Variant of the vehicle model",
            "nullable": true,
            "example": "Long Range"
          },
          "releaseYear": {
            "type": "integer",
            "description": "Release year of the vehicle model",
            "format": "int32",
            "nullable": true,
            "example": 2021
          },
          "pictureUrl": {
            "type": "string",
            "description": "URL of the vehicle model picture",
            "nullable": true,
            "example": "https://imgix.monta.com/models/tesla-model3.png"
          },
          "capacityKwh": {
            "type": "number",
            "description": "Battery capacity in kWh",
            "format": "double",
            "nullable": true,
            "example": 72.5
          },
          "maxKwAc": {
            "type": "number",
            "description": "Maximum AC charging power in kW",
            "format": "double",
            "nullable": true,
            "example": 11
          },
          "maxKwDc": {
            "type": "number",
            "description": "Maximum DC charging power in kW",
            "format": "double",
            "nullable": true,
            "example": 150
          },
          "displayName": {
            "type": "string",
            "description": "Display name of the vehicle model",
            "example": "Tesla Model 3 Long Range (2021) - 72 kWh"
          },
          "connectors": {
            "type": "array",
            "description": "List of connectors supported by this vehicle model",
            "items": {
              "$ref": "#/components/schemas/VehicleConnector"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "BearerAccessToken": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "x-stability-level": "stable"
}
```