Developer Documentation

Vehicle Ingestion API

Integrate your DMS directly with Auterio. Push vehicle data via a simple REST API and keep your inventory synchronized automatically.

1Quick Start

POST/api/vehicles/ingest

Authentication: Include your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json

Max vehicles per request: 1,000

2Example Request

cURL

curl -X POST https://auterio.net/api/vehicles/ingest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicles": [
    {
      "vin": "WVWZZZE1ZNP123456",
      "brand": "Volkswagen",
      "model": "Golf",
      "version": "GTI 2.0 TSI",
      "year": 2024,
      "color_ext": "Negro",
      "fuel_type": "gasolina",
      "gearbox": "automático",
      "mileage": 15000,
      "power_hp": 245,
      "cost_price": 28000,
      "sale_price": 34500,
      "status": "disponible"
    },
    {
      "vin": "WBA11AA00PCJ12345",
      "brand": "BMW",
      "model": "320d",
      "year": 2023,
      "mileage": 42000,
      "cost_price": 22000,
      "sale_price": 28900
    }
  ]
}'

✓Success Response

200 OK

{
  "success": true,
  "imported": 2,
  "skipped": 0,
  "source": "DMS Cliente XYZ"
}

401Unauthorized

Missing or invalid Authorization header

403Forbidden

API key is invalid or inactive

400Bad Request

Invalid payload or no valid vehicles

3Fields Reference

Field	Type	Required	Description
`vin`	string	required	Vehicle Identification Number
`brand`	string	required	Vehicle brand (e.g. Volkswagen, BMW)
`model`	string	required	Vehicle model (e.g. Golf, 3 Series)
`matricula`	string	optional	License plate number
`version`	string	optional	Trim / version (e.g. GTI 2.0 TSI)
`year`	integer	optional	Registration year
`color_ext`	string	optional	Exterior color
`color_int`	string	optional	Interior color
`fuel_type`	string	optional	Fuel type (gasoline, diesel, electric, hybrid)
`gearbox`	string	optional	Transmission type (manual, automatic)
`mileage`	integer	optional	Mileage in km
`engine_cc`	integer	optional	Engine displacement in cc
`power_hp`	integer	optional	Power in HP
`doors`	integer	optional	Number of doors
`seats`	integer	optional	Number of seats
`cost_price`	number	optional	Cost price (excl. VAT)
`sale_price`	number	optional	Sale price (retail)
`status`	string	optional	Status: disponible, reservado, vendido, transito, baja (default: disponible)
`location`	string	optional	Vehicle location
`supplier`	string	optional	Supplier
`fecha_matricula`	date	optional	First registration date (YYYY-MM-DD)
`propiedad`	string	optional	Owning company
`categoria`	string	optional	Vehicle category
`notes`	string	optional	Additional notes

ℹBehavior

Upsert by VIN

If a vehicle with the same VIN already exists, it will be updated. Otherwise, a new vehicle is created.

Default Status

If no status is provided, vehicles default to "disponible".

Batch Processing

All vehicles in a single request are processed atomically. Up to 1,000 vehicles per request.

Error Handling

Invalid vehicles are skipped but the rest of the batch continues. Errors are returned in the response.