Skip to main content

Calculate minimum price for freight transport

GET 
/company/minimal

Calculate the minimum viable price for transporting goods between two points, incorporating all operational costs, platform commissions, and profit margins. This is the main pricing endpoint used on the platform.

Objective​

Provide an accurate minimum price that covers all operational costs while maintaining competitive rates for freight transport services.

Use Cases​

  • Set minimum bid amounts when creating auctions
  • Validate if a bid price is economically viable
  • Calculate floor prices for transport contracts
  • Support for dynamic pricing algorithms
  • Generate price estimates for customers
  • Prevent below-cost prices in competitive bidding

Pricing Algorithm​

The minimum price calculation follows this formula:

  1. Base Cost: Gross cost from the external routing API (fuel, maintenance, time)
  2. Random Factor: settings.pricing.today_random % variation on the base cost
  3. Profit Margin: settings.pricing.general_gain % added to the cost
  4. Platform Commission: settings.pricing.fee % (typically 3%)
  5. Safety Margin: Additional 5% on the total
  6. Volume Price: (volume / 30) * totalCost — proportional to load volume
  7. Weight Price: (weight / 44000) * totalCost — only applied when weight >= 22,000 kg (50%)

Final price = max(volumePrice, weightPrice, totalCost/2) with a minimum of €100 Average fuel consumption used: 32L/100km

Validation Rules​

  • Maximum volume: 30 m³ (capped if exceeded)
  • Maximum weight: 44,000 kg (capped if exceeded)
  • Minimum price: €100 (prevents zero or negative prices)
  • Same origin and destination returns minimum values (1 km, €0)

Parameter Priority​

Location identifier priority:

  1. idEtl/idEtd: Database address IDs (highest priority)
  2. zipcodeStart/zipcodeEnd: Search by postal code
  3. coordsStart/coordsEnd: GPS coordinates
  • Coordinate search finds the nearest address within a 100 km radius

Error Responses​

  • 400: Invalid parameters or missing location identifiers
  • 404: Addresses not found
  • 500: External service error or pricing configuration not found

Request​

Responses​

Minimum price calculated correctly