Skip to main content

Create auction

POST 
/api/auction/

Create a new public transportation auction.Requirements:- Authenticated user with valid company- Coherent dates (etl_date < etd_date)- Valid cargo dimensions (weight > 0, height > 0)- Valid load/unload addressesValidations performed:1. Generate a unique service_code based on addresses2. Validate schedules and dates3. Verify cargo dimensions4. Create database recordMandatory fields:- etl_date: Load date/time- etd_date: Unload date/time- cargo_weight: Cargo weight (kg)- cargo_height: Cargo height (m)- etl_address/etd_address: Address IDsExample request body:json{ etl_date: 2025-08-15T08:00:00Z, etd_date: 2025-08-15T18:00:00Z, cargo_weight: 1000, cargo_height: 2.5, etl_address: 60a1b2c3d4e5f6a1b2c3d4e5, etd_address: 60a1b2c3d4e5f6a1b2c3d4e6}The response includes the created auction with its unique service_code.

Request​

Responses​

Individual auction