Central Transport - API Docs

GET /api/ct-location?zip=:zip&city=:city

CT Location by ZIP Code

Look up Central Transport service coverage for a US ZIP code. Returns terminal info, service type, and timezone data.

Query Parameters

Parameter	Type	Description
`zip` required	`string`	5-digit US ZIP code
`city` optional	`string`	City name to disambiguate multi-city ZIPs

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`zip`	`string`	The queried ZIP code
`status`	`string`	served \| multi_city \| not_served
`location`	`object`	Location with terminal details (when status=served)
`cities`	`array`	Array of candidate cities (when status=multi_city)
`message`	`string`	Human-readable status message

Code Examples

curl "https://freightapis.dev/api/ct-location?zip=08807" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "zip": "08807",
  "status": "served",
  "location": {
    "city": "BRIDGEWATER",
    "state": "NJ",
    "zip": "08807",
    "isDirect": true,
    "terminal": {
      "number": "089",
      "city": "NORTH BRUNSWICK",
      "address": "1305 Livingston Avenue",
      "state": "NJ",
      "postalCode": "08902",
      "mapName": "089-NEW BRUNSWICK - NJ",
      "mapUrl": "https://www.centraltransport.com/servicemaps/2021/089-New Brunswick - NJ.pdf"
    },
    "timezone": 0,
    "differenceFromEst": 0
  }
}

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

Search CT Locations

Search Central Transport locations by city or state. Returns paginated results matching the query. Requires a Starter or higher plan.

Starter+ required

Query Parameters

Parameter	Type	Description
`q` required	`string`	Search query (minimum 2 characters). Matches city and state.
`page` optional	`integer`	Page number for pagination (default: 1)

Response Fields

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

Code Examples

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

{
  "success": true,
  "query": "dallas",
  "locations": [
    {
      "city": "DALLAS",
      "state": "TX",
      "zip": "75201",
      "isDirect": true,
      "terminal": { "number": "042", "city": "DALLAS" }
    }
  ],
  "total": 18,
  "currentPage": 1,
  "totalPages": 1
}

GET /api/ct-location/terminal/:num

Terminal Lookup

Retrieve all ZIP code locations served by a specific Central Transport terminal number.

URL Parameters

Parameter	Type	Description
`num` required	`string`	CT terminal number
`page` optional	`integer`	Page number for pagination (default: 1)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`terminalNumber`	`string`	The queried CT terminal number
`locations`	`array`	Array of CT location objects served by this terminal
`total`	`integer`	Total number of locations served
`currentPage`	`integer`	Current page number
`totalPages`	`integer`	Total number of pages

Code Examples

curl "https://freightapis.dev/api/ct-location/terminal/089" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "terminalNumber": "089",
  "locations": [
    {
      "city": "BRIDGEWATER",
      "state": "NJ",
      "zip": "08807",
      "isDirect": true,
      "terminal": { "number": "089", "city": "NORTH BRUNSWICK" }
    }
  ],
  "total": 97,
  "currentPage": 1,
  "totalPages": 5
}

POST /api/ct-location/batch

Batch ZIP Lookup

Look up Central Transport coverage for multiple ZIP codes in a single request.

Request Body

Parameter	Type	Description
`zips` required	`string[]`	Array of 5-digit ZIP codes. Max 20 for Pro, 50 for Enterprise.

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`results`	`object`	Map of ZIP to {status, location}
`summary`	`object`	{served, multi_city, not_served, total}

Code Examples

curl -X POST "https://freightapis.dev/api/ct-location/batch" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"zips": ["08807", "75201", "90001"]}'

{
  "success": true,
  "results": {
    "08807": { "status": "served", "location": { "city": "BRIDGEWATER", "state": "NJ" } },
    "75201": { "status": "served", "location": { "city": "DALLAS", "state": "TX" } },
    "90001": { "status": "served", "location": { "city": "LOS ANGELES", "state": "CA" } }
  },
  "summary": { "served": 3, "multi_city": 0, "not_served": 0, "total": 3 }
}

GET /api/ct-location/coverage?state=:state

State Coverage

Retrieve Central Transport service coverage statistics for a US state.

Query Parameters

Parameter	Type	Description
`state` required	`string`	2-letter US state code (e.g., NJ)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`state`	`string`	The queried state code
`totalZips`	`integer`	Total number of ZIP codes queried in the state
`directService`	`integer`	Number of ZIPs with direct CT service
`indirectService`	`integer`	Number of ZIPs with indirect CT service

Code Examples

curl "https://freightapis.dev/api/ct-location/coverage?state=NJ" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "state": "NJ",
  "totalZips": 612,
  "directService": 543,
  "indirectService": 41
}