TForce Freight - API Docs

GET /api/tforce-location?state=:state&zip=:zip&country=:country

TForce Location by State or ZIP

Look up TForce Freight service centers by state code or ZIP code. Covers US, Canada, and Mexico. Returns terminal details including timezone and mailing address.

Query Parameters

Parameter	Type	Description
`state` optional	`string`	State/province code (e.g., GA, PQ, JA). Required if zip not provided.
`zip` optional	`string`	ZIP/postal code. Takes priority over state if both provided.
`country` optional	`string`	Filter by country: US, CA, or MX

Response Fields

Field	Type	Description
`locations[].alphaCode`	`string`	Terminal code (e.g., ATL)
`locations[].terminalName`	`string`	Terminal name
`locations[].address`	`object`	Physical address with street, city, state, zip, country
`locations[].contact`	`object`	Phone and fax
`locations[].timezone`	`string`	Timezone (Eastern, Central, Pacific, Mountain)
`locations[].mailingAddress`	`object`	Mailing address (may differ from physical)

Code Examples

curl "https://freightapis.dev/api/tforce-location?state=GA" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "state": "GA",
  "country": "all",
  "total": 5,
  "locations": [
    {
      "alphaCode": "ATL",
      "terminalName": "ATLANTA",
      "address": {
        "street": "2427 MORELAND AVE SE",
        "city": "ATLANTA",
        "state": "GA",
        "zip": "30315-5724",
        "country": "US"
      },
      "contact": { "phone": "(800)333-7400", "fax": "(404)635-3224" },
      "timezone": "Eastern",
      "mailingAddress": { ... }
    }
  ]
}

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

Search TForce Terminals

Full-text search across terminal names, cities, addresses, and alpha codes across all three countries. Paginated.

Query Parameters

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

Code Examples

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

{
  "success": true,
  "query": "montreal",
  "locations": [ ... ],
  "total": 1,
  "currentPage": 1,
  "totalPages": 1
}

GET /api/tforce-location/terminal/:code

Terminal by Alpha Code

Look up TForce service center(s) by alpha code. A code may exist in multiple countries.

Path Parameters

Parameter	Type	Description
`code` required	`string`	Terminal alpha code (e.g., ATL, MTL)

Code Examples

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

{
  "success": true,
  "total": 1,
  "locations": [ { "alphaCode": "ATL", ... } ]
}

GET /api/tforce-location/coverage

TForce Coverage Statistics

Returns aggregate statistics: total service centers, breakdown by country and state/province.

Code Examples

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

{
  "success": true,
  "totalLocations": 291,
  "byCountry": [
    { "country": "US", "count": 210 },
    { "country": "MX", "count": 63 },
    { "country": "CA", "count": 18 }
  ],
  "byState": [ ... ]
}

POST /api/tforce-location/batch

Batch State Lookup

Retrieve service centers for multiple states in a single request. Maximum 10 states per call.

Request Body

Parameter	Type	Description
`states` required	`string[]`	Array of state/province codes (max 10)

Code Examples

curl -X POST "https://freightapis.dev/api/tforce-location/batch" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"states": ["GA", "TX", "PQ"]}'

{
  "success": true,
  "results": {
    "GA": { "total": 5, "locations": [ ... ] },
    "TX": { "total": 15, "locations": [ ... ] },
    "PQ": { "total": 2, "locations": [ ... ] }
  },
  "summary": { "statesRequested": 3, "totalLocations": 22 }
}