Quickstart Guide

Get from zero to your first freight rate lookup in under 5 minutes.

1. Get Your API Key (30 seconds)

  1. Sign up at freightrateintelligence.com
  2. Go to Dashboard → Settings → API Keys
  3. Click Generate Key
  4. Copy and store the key securely — it won't be shown again

Note: Your API key starts with fri_. Keep it secret. Never commit it to source code.

2. Your First Rate Lookup

curl -X POST https://freightrateintelligence.com/v1/rates/lookup \
  -H "Authorization: Bearer fri_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "Chicago, IL",
    "destination": "Dallas, TX",
    "equipment": "DRY_VAN"
  }'

3. Understanding the Response

FieldDescription
rate_per_mileAll-in rate in USD per mile
total_costTotal lane cost (rate_per_mile × miles)
confidence.levelConfidence grade: HIGH, MEDIUM, or LOW
cost_componentsPer-mile breakdown: fuel, labor, equipment, margin, FSC
capacity_pressureRegional capacity index (0–100), label, adjustment %
factor_versionsData source versions with fetch timestamps
receipt_idConstitutional receipt — cryptographic record of this query
auth_obj_idAttribution object linking to data source provenance

4. Next Steps