Skip to main content

Developer Reference

TForce Freight Terminal Lookup

Find any TForce Freight terminal or service center across the US, Canada, and Mexico - search by state, ZIP, or terminal code, with timezone and mailing address data. Free to use, plus a REST API for batch lookups and transit info from your own app.

Get API Key ← Overview Interactive API Reference
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[].id integer Internal location ID
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 YOUR_API_KEY"

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)

Response Fields

Field Type Description
success boolean Indicates whether the request succeeded
query string The search query echoed back
locations[].id integer Internal location ID
locations[].alphaCode string Terminal code (e.g., ATL)
locations[].terminalName string Terminal name
locations[].address object { street, city, state, zip, country }
locations[].contact object { phone, fax }
locations[].timezone string Timezone (Eastern, Central, Pacific, Mountain)
locations[].mailingAddress object { street, city, state, zip } (may differ from physical)
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/tforce-location/search?q=montreal" \
  -H "Authorization: Bearer YOUR_API_KEY"
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)

Response Fields

Field Type Description
success boolean Indicates whether the request succeeded
total integer Number of matching terminals
locations[].id integer Internal location ID
locations[].alphaCode string Terminal code (e.g., ATL)
locations[].terminalName string Terminal name
locations[].address object { street, city, state, zip, country }
locations[].contact object { phone, fax }
locations[].timezone string Timezone (Eastern, Central, Pacific, Mountain)
locations[].mailingAddress object { street, city, state, zip } (may differ from physical)

Code Examples

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

TForce Coverage Statistics

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

Response Fields

Field Type Description
success boolean Indicates whether the request succeeded
totalLocations integer Total number of TForce terminals
byCountry array [ { country, count } ]
byState array [ { state, country, count } ]

Code Examples

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

Batch State Lookup

Retrieve service centers for multiple states in a single request. Maximum 20 states per request (50 for Enterprise).

Request Body

Parameter Type Description
states required string[] Array of state/province codes. Max 20 for Pro, 50 for Enterprise.

Response Fields

Field Type Description
success boolean Indicates whether the request succeeded
results object Map of key to a per-key result: { total, locations[] } keyed by 2-letter state code
summary object Aggregate counts for the request

Code Examples

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

TForce Terminal Lookup - FAQ

How do I look up a TForce Freight terminal?

Search by state, ZIP code, or terminal code. FreightAPIs returns the TForce Freight terminal address, timezone, and mailing data instantly across the US, Canada, and Mexico - free to use, with a REST API for programmatic and batch queries.

Is the TForce Freight terminal lookup free?

Yes. Terminal lookup is free for all plans. The Free tier includes 20 API calls per month; paid plans raise the monthly quota for higher-volume lookups.

Can I look up multiple TForce terminals at once?

Yes. The batch endpoint accepts up to 20 terminal lookups per request (50 for Enterprise), so you can resolve many states, ZIPs, or terminal codes in a single call.

Is there a public TForce Freight API?

TForce Freight (formerly UPS Freight) offers official rating and tracking APIs to shippers with a TForce account. For service-center location data specifically, FreightAPIs provides an independent REST API over TForce terminals in the US, Canada, and Mexico - no TForce account required, with a free API key.