MUmultigest
Vehicles (Protected)

List Vehicles

List vehicles with pagination and comprehensive filters.

Returns:

  • Matricula (primary or secondary with | separator)
  • Marca, Modelo names
  • Formatted price with VAT indication
  • Calculated profit from movements
  • Days since entry
  • Status flags (consignado, emprestado, seguro, fechado)
  • Alert messages (inspection, ads, etc.)
get/api/vehicles/

Request

  • Base URL
    https://api.multigest.pt (the document declares no server; this is the origin it was published from)
  • URL
    https://api.multigest.pt/api/vehicles/
  • Auth
    API key in header x-api-token and API key in header x-origin-verify

Query parameters

pageinteger

Page number

limitinteger

Items per page

idsinteger[]

Re-read exactly these vehicle IDs (bypasses paging, max 100). Used by the stock list to refresh rows edited in another tab.

pv_idsinteger[]

Filter by one or more point of sale IDs

fechadoboolean nullable

Filter by closed status (true=closed, false=open)

estadointeger nullable

Filter by state ID — dbo.EstadoViatura (1=Por Anunciar, 2=Em Stock, 3=Reservado, 4=Vendido, 5=Suspenso)

consignadoboolean nullable

Filter consigned vehicles

emprestadoboolean nullable

Filter loaned vehicles

seguroboolean nullable

Filter vehicles with active insurance

importadoboolean nullable

Filter imported vehicles

section_idinteger nullable

Filter by Integrazu section ID

marca_idinteger nullable

Filter by brand ID

modelo_idinteger nullable

Filter by model ID

combustivel_idinteger nullable

Filter by fuel type ID

caixa_idinteger nullable

Filter by transmission ID

second_key_statusstring nullable

Filter by second-key status: sim, não, requisitado

fornecedor_idinteger nullable

Filter by supplier (Cliente ID referenced by Viatura.Fornece)

preco_minnumber nullable

Minimum price

preco_maxnumber nullable

Maximum price

ano_mininteger nullable

Minimum year (DataMat)

ano_maxinteger nullable

Maximum year (DataMat)

km_mininteger nullable

Minimum kilometers

km_maxinteger nullable

Maximum kilometers

has_anuncioboolean nullable

Filter by ad status (true=has ad, false=no ad)

renew_inactiveboolean nullable

Filter vehicles with active exports but auto-renew disabled

only_retomasboolean nullable

Show only trade-in (retoma) vehicles

sem_inspecaoboolean nullable

Filter by inspection validity (true=no valid inspection: overdue or not filled, false=has valid inspection)

iuc_caducadoboolean nullable

Filter by IUC status (true=missed, unsettled IUC deadline; false=IUC in order). 100%-electric vehicles are exempt and never match.

localizacaointeger nullable

Filter by location: 0=parque, 1=transporte

prep_statusstring nullable

Filter by prep status: nao_iniciada, em_curso, concluida

pronto_entregaboolean nullable

Filter by commercial readiness

buffer_blockedboolean nullable

Filter by sale block status

exclude_buffer_blockedboolean nullable

Exclude buffer-blocked vehicles

current_park_location_idsinteger[]

Filter by one or more current park location IDs

searchstring nullable

Search by plate, brand, or model

sort_bystring nullable

Sort field: dataentr, preco, km, marca

sort_orderstring nullable

Sort order: asc or desc

Headers

x-api-tokenstring nullable

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 21 revisions of this API.