Rates API

Get Market Rate

Retrieve current market rate for a specific lane.

Endpoint

GET /api/v1/rates

Query Parameters

Example Request

curl -X GET 'https://api.drayrates.ai/api/v1/rates?origin=USLAX&destination=USCHI&equipment_type=dryvan' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "rate": {
    "base_rate": 2850.0,
    "fuel_surcharge": 425.0,
    "total_rate": 3275.0,
    "currency": "USD"
  },
  "market_data": {
    "confidence_score": 0.85,
    "sample_size": 124,
    "last_updated": "2024-03-20T15:30:00Z"
  },
  "route": {
    "origin": "USLAX",
    "destination": "USCHI",
    "distance_miles": 2004,
    "estimated_transit_days": 3
  }
}

Get Historical Rates

Retrieve historical rate trends for a specific lane.

Endpoint

GET /api/v1/rates/historical

Query Parameters

Example Request

curl -X GET 'https://api.drayrates.ai/api/v1/rates/historical?origin=USLAX&destination=USCHI&equipment_type=dryvan&start_date=2024-01-01&end_date=2024-03-20' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "historical_rates": [
    {
      "date": "2024-01-01",
      "base_rate": 2750.0,
      "total_rate": 3150.0
    },
    {
      "date": "2024-02-01",
      "base_rate": 2800.0,
      "total_rate": 3200.0
    },
    {
      "date": "2024-03-01",
      "base_rate": 2850.0,
      "total_rate": 3275.0
    }
  ],
  "trend_analysis": {
    "average_rate": 3208.33,
    "rate_volatility": "low",
    "trend_direction": "upward"
  }
}

Error Responses

Error Response Example

{
  "error": {
    "code": "INVALID_PARAMETERS",
    "message": "Invalid origin location provided",
    "details": {
      "field": "origin",
      "reason": "Location code INVALID not found"
    }
  }
}