TForce Freight API - Terminal Lookup by State & ZIP

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
`success`	`boolean`	Indicates whether the request succeeded
`state`	`string`	The queried state code
`country`	`string`	The queried country, or "all"
`total`	`integer`	Number of terminals returned
`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[].lat`	`number \| null`	Latitude of the terminal (null when not geocoded)
`locations[].lng`	`number \| null`	Longitude of the terminal (null when not geocoded)
`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"

{
  "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)

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[].lat`	`number \| null`	Latitude of the terminal (null when not geocoded)
`locations[].lng`	`number \| null`	Longitude of the terminal (null when not geocoded)
`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"

{
  "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)

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[].lat`	`number \| null`	Latitude of the terminal (null when not geocoded)
`locations[].lng`	`number \| null`	Longitude of the terminal (null when not geocoded)
`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"

{
  "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.

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"

{
  "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 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"]}'

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

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?

The lookup pages on this site are free with no signup. API access starts with the Starter plan; higher plans raise the monthly quota.

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 Starter API key.

TForce Freight Terminal Lookup

TForce Location by State or ZIP

Query Parameters

Response Fields

Code Examples

Search TForce Terminals

Query Parameters

Response Fields

Code Examples

Terminal by Alpha Code

Path Parameters

Response Fields

Code Examples

TForce Coverage Statistics

Response Fields

Code Examples

Batch State Lookup

Request Body

Response Fields

Code Examples

TForce Terminal Lookup - FAQ

How do I look up a TForce Freight terminal?

Is the TForce Freight terminal lookup free?

Can I look up multiple TForce terminals at once?

Is there a public TForce Freight API?