---
title: "Get Vehicle Contracts"
method: GET
path: "/api/vehicles/{vehicle_id}/contracts"
tags: ["Vehicles (Protected)"]
---

# Get Vehicle Contracts

`GET /api/vehicles/{vehicle_id}/contracts`

Get all contracts for a vehicle.

Returns contracts with:
- Client name
- Dates (contract, close)
- Values (reserve, sale)
- Calculated commission

By default, suspended contracts (IDestado=3) are hidden. Pass
`?include_suspended=true` to include them — the frontend toggle drives this.

## Path parameters

- `vehicle_id` integer, required

## Query parameters

- `include_suspended` boolean — Include IDestado=3 (Suspenso) rows

## Headers

- `x-api-token` string, nullable

## Response `200`

Successful Response

- VehicleContractResponse[]
  - `ID` integer, required
  - `Viatura` integer, required
  - `Cliente` integer, nullable
  - `Nome` string, nullable
  - `ClienteNIF` union
    - integer
    - string
  - `ClienteContacto` string, nullable
  - `Data` string, date-time, nullable
  - `Dataentrega` string, date-time, nullable
  - `Datafecho` string, date-time, nullable
  - `Reservaate` string, date, nullable
  - `ValorReserva` number, nullable
  - `ValorVenda` number, nullable
  - `ValoremFalta` number, nullable
  - `Iva` number, nullable
  - `IDestado` integer, nullable
  - `EstadoNome` string, nullable
  - `Fechado` boolean, nullable
  - `financiado` boolean, nullable
  - `temretoma` boolean, nullable
  - `garantia` integer, nullable
  - `meses_garantia` integer, nullable
  - `Oferta1` string, nullable
  - `Oferta2` string, nullable
  - `Oferta3` string, nullable
  - `Oferta4` string, nullable
  - `Oferta5` string, nullable
  - `Oferta6` string, nullable
  - `transportepara` string, nullable
  - `Comercial` integer, nullable
  - `ComercialNome` string, nullable
  - `idresponsavel` integer, nullable
  - `ResponsavelNome` string, nullable
  - `FaturaID` integer, nullable
  - `IDpontodevenda` integer, nullable
  - `PontoDeVendaNome` string, nullable
  - `bucketurl` string, nullable
  - `ViaturaMatricula` string, nullable
  - `ViaturaMarca` string, nullable
  - `ViaturaModelo` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)