CEVA Logistics - API Docs

GET /api/ceva-location?country_code=:code&city=:city

CEVA Location by Country

Look up CEVA Logistics offices and warehouses in a country by ISO country code. Optionally filter by city.

Query Parameters

Parameter	Type	Description
`country_code` required	`string`	2-3 letter ISO country code
`city` optional	`string`	City name filter

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`countryCode`	`string`	The queried country code
`total`	`number`	Total number of locations found
`locations`	`array`	Array of location objects with address, coordinates, activities

Code Examples

curl "https://freightapis.dev/api/ceva-location?country_code=US" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "countryCode": "US",
  "total": 75,
  "locations": [
    {
      "nid": "5465",
      "title": "CEVA Freight LLC - Anchorage",
      "address": {
        "line1": "11100 Calaska Circle",
        "city": "Anchorage",
        "country": "United States",
        "countryCode": "US"
      },
      "coordinates": { "latitude": 61.1207, "longitude": -149.8851 },
      "activities": ["AIR", "GROUND"]
    }
  ]
}

GET /api/ceva-location/search?q=:query

Search CEVA Locations

Search CEVA Logistics locations worldwide by office name, city, or country. Returns paginated results.

Query Parameters

Parameter	Type	Description
`q` required	`string`	Search query, min 2 characters
`page` optional	`number`	Page number (default 1)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`query`	`string`	The search query used
`locations`	`array`	Matching CEVA location objects
`total`	`number`	Total number of matching results
`currentPage`	`number`	Current page number
`totalPages`	`number`	Total number of pages

Code Examples

curl "https://freightapis.dev/api/ceva-location/search?q=Frankfurt" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "query": "Frankfurt",
  "locations": [
    {
      "nid": "3201",
      "title": "CEVA Logistics - Frankfurt am Main",
      "address": {
        "line1": "Cargo City South, Building 534",
        "city": "Frankfurt am Main",
        "country": "Germany",
        "countryCode": "DE"
      },
      "coordinates": { "latitude": 50.0379, "longitude": 8.5622 },
      "activities": ["AIR", "OCEAN", "RAIL", "GROUND", "VAS"]
    }
  ],
  "total": 1,
  "currentPage": 1,
  "totalPages": 1
}

GET /api/ceva-location/country/:code

All Locations in Country

Get all CEVA Logistics locations in a specific country.

Query Parameters

Parameter	Type	Description
`code` required	`string`	2-3 letter ISO country code in URL path

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`countryCode`	`string`	The queried country code
`total`	`number`	Total number of locations found
`locations`	`array`	Array of CEVA location objects

Code Examples

curl "https://freightapis.dev/api/ceva-location/country/DE" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "countryCode": "DE",
  "total": 9,
  "locations": [
    {
      "nid": "3201",
      "title": "CEVA Logistics - Frankfurt am Main",
      "address": {
        "line1": "Cargo City South, Building 534",
        "city": "Frankfurt am Main",
        "country": "Germany",
        "countryCode": "DE"
      },
      "coordinates": { "latitude": 50.0379, "longitude": 8.5622 },
      "activities": ["AIR", "OCEAN", "RAIL", "GROUND", "VAS"]
    }
  ]
}

POST /api/ceva-location/batch

Batch Country Lookup

Look up CEVA locations for multiple countries in a single request. Maximum 20 country codes per request (50 for Enterprise).

Request Body

Parameter	Type	Description
`country_codes` required	`string[]`	Array of 2-3 letter ISO country codes

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`results`	`object`	Map of country code to locations
`summary`	`object`	countriesRequested and totalLocations counts

Code Examples

curl -X POST "https://freightapis.dev/api/ceva-location/batch" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"country_codes": ["US", "DE"]}'

{
  "success": true,
  "results": {
    "US": [
      {
        "nid": "5465",
        "title": "CEVA Freight LLC - Anchorage",
        "address": { "city": "Anchorage", "countryCode": "US" }
      }
    ],
    "DE": [
      {
        "nid": "3201",
        "title": "CEVA Logistics - Frankfurt am Main",
        "address": { "city": "Frankfurt am Main", "countryCode": "DE" }
      }
    ]
  },
  "summary": { "countriesRequested": 2, "totalLocations": 84 }
}

GET /api/ceva-location/coverage?continent=:code

Coverage Statistics

Get CEVA Logistics coverage statistics by continent. Optionally filter by a specific continent code.

Query Parameters

Parameter	Type	Description
`continent` optional	`string`	Continent code filter, e.g. CT-EU, CT-NA, CT-AS

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`continents`	`array`	Array with continentCode, totalLocations, totalCountries

Code Examples

curl "https://freightapis.dev/api/ceva-location/coverage" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "continents": [
    { "continentCode": "CT-EU", "totalLocations": 238, "totalCountries": 36 },
    { "continentCode": "CT-NA", "totalLocations": 115, "totalCountries": 21 },
    { "continentCode": "CT-AS", "totalLocations": 138, "totalCountries": 38 }
  ]
}

GET /api/ceva-location/nearby?lat=:lat&lng=:lng&radius=:km

Nearby Locations

Find CEVA Logistics locations near a geographic point. Uses Haversine distance calculation. Results sorted by distance.

Query Parameters

Parameter	Type	Description
`lat` required	`number`	Latitude (-90 to 90)
`lng` required	`number`	Longitude (-180 to 180)
`radius` optional	`number`	Search radius in km (default 50, max 500)
`page` optional	`number`	Page number (default 1)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`center`	`object`	The queried center point (lat, lng)
`radiusKm`	`number`	The search radius used
`locations`	`array`	Locations with distanceKm field
`total`	`number`	Total number of matching results
`currentPage`	`number`	Current page number
`totalPages`	`number`	Total number of pages

Code Examples

curl "https://freightapis.dev/api/ceva-location/nearby?lat=50.05&lng=8.59&radius=100" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "center": { "lat": 50.05, "lng": 8.59 },
  "radiusKm": 100,
  "locations": [
    {
      "nid": "3201",
      "title": "CEVA Logistics - Frankfurt am Main",
      "address": {
        "city": "Frankfurt am Main",
        "country": "Germany",
        "countryCode": "DE"
      },
      "coordinates": { "latitude": 50.0379, "longitude": 8.5622 },
      "distanceKm": 1,
      "activities": ["AIR", "OCEAN", "RAIL", "GROUND", "VAS"]
    }
  ],
  "total": 1,
  "currentPage": 1,
  "totalPages": 1
}

GET /api/ceva-location/activities?type=:type

Filter by Activity

Filter CEVA locations by activity/service type. Valid types: AIR, OCEAN, GROUND, RAIL, CONTRACT LOGISTICS, LEAD LOGISTICS, FVL, VAS.

Query Parameters

Parameter	Type	Description
`type` required	`string`	Activity type
`page` optional	`number`	Page number (default 1)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`activity`	`string`	The queried activity type
`locations`	`array`	Matching CEVA location objects
`total`	`number`	Total number of matching results
`currentPage`	`number`	Current page number
`totalPages`	`number`	Total number of pages

Code Examples

curl "https://freightapis.dev/api/ceva-location/activities?type=OCEAN" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "activity": "OCEAN",
  "locations": [
    {
      "nid": "3201",
      "title": "CEVA Logistics - Frankfurt am Main",
      "address": {
        "city": "Frankfurt am Main",
        "country": "Germany",
        "countryCode": "DE"
      },
      "activities": ["AIR", "OCEAN", "RAIL", "GROUND", "VAS"]
    }
  ],
  "total": 1,
  "currentPage": 1,
  "totalPages": 1
}

GET /api/ceva-location/contacts?country_code=:code

Country Contacts

Get CEVA Logistics contact information for a specific country. Returns sales contacts, department contacts, and country-level contact info.

Query Parameters

Parameter	Type	Description
`country_code` required	`string`	2-3 letter ISO country code

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`countryCode`	`string`	The queried country code
`total`	`number`	Total number of contacts found
`contacts`	`array`	Contact objects with title, email, phone, function, and country-level info

Code Examples

curl "https://freightapis.dev/api/ceva-location/contacts?country_code=US" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "countryCode": "US",
  "total": 2,
  "contacts": [
    {
      "title": "Sales Department",
      "email": "sales.us@cevalogistics.com",
      "phone": "+1-800-888-4949",
      "function": "Sales",
      "country": "United States",
      "countryCode": "US"
    },
    {
      "title": "Customer Service",
      "email": "cs.us@cevalogistics.com",
      "phone": "+1-800-888-4950",
      "function": "Customer Service",
      "country": "United States",
      "countryCode": "US"
    }
  ]
}