Country Codes

Use ISO 3166-1 alpha-2 codes for the origin_country and dest_country parameters. Codes are case-insensitive.

Coverage Levels

Our data coverage varies by country and corridor. Here's what each level means:

Countries by Coverage

Usage Example

{
  "origin_country": "PL",
  "dest_country": "DE"
}

Country codes are case-insensitive. These are equivalent:

{ "origin_country": "PL" }
{ "origin_country": "pl" }
{ "origin_country": "Pl" }

Top Corridors

These routes have the highest data volume and reliability:

Handling Low-Coverage Routes

For routes with limited data:

1. Use Broader Time Ranges

{
  "origin_country": "GR",
  "dest_country": "DE",
  "date_range_days": 90
}

2. Remove City Filters

Country-level data aggregates more offers:

{
  "origin_country": "GR",
  "dest_country": "DE"
  // No origin_city or dest_city
}

3. Check Confidence Score

Always check the confidence field:

if (data.confidence === 'low' || data.confidence === 'none') {
  console.warn('Limited data for this route. Use benchmark with caution.');
}

4. Consider Proxy Routes

For very sparse routes, consider nearby major corridors as a reference point.

Common Issues

Invalid Country Code

{
  "error": {
    "code": "INVALID_COUNTRY_CODE",
    "message": "Invalid country code: UK. Use GB for United Kingdom."
  }
}

Common mistakes:

• UK → Use GB (United Kingdom)
• GER → Use DE (Germany)
• Poland → Use PL

Country Not Supported

If you use a valid ISO code that we don't support:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Country not supported: US"
  }
}

Our API covers European freight only.

Last updated: February 1, 2026