Estes Express - API Docs

GET /api/estes-location?state=:state&zip=:zip

Estes Location by State or ZIP

Look up Estes Express terminal locations by US state code or ZIP code. Returns terminal details including address and contact information.

Query Parameters

Parameter	Type	Description
`state` optional	`string`	2-letter state code (e.g., AL, CA). Required if zip not provided.
`zip` optional	`string`	ZIP code. Takes priority over state if both provided.

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`state`	`string`	The queried state code
`total`	`integer`	Number of terminals returned
`locations[].alphaCode`	`string`	Unique terminal code (e.g., BHM)
`locations[].terminalNumber`	`integer`	Terminal number
`locations[].terminalName`	`string`	Terminal name
`locations[].address`	`object`	Address with street, city, state, zip, country
`locations[].contact`	`object`	Contact with phone and fax

Code Examples

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

{
  "success": true,
  "state": "AL",
  "total": 4,
  "locations": [
    {
      "id": 1,
      "alphaCode": "BHM",
      "terminalNumber": 43,
      "terminalName": "Birmingham",
      "address": {
        "street": "3901 16th Avenue North",
        "city": "Birmingham",
        "state": "AL",
        "zip": "35234",
        "country": "US"
      },
      "contact": {
        "phone": "(205) 841-9372",
        "fax": "(205) 841-9378"
      }
    }
  ]
}

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

Search Estes Terminals

Full-text search across terminal names, cities, addresses, and alpha codes. Results are 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/estes-location/search?q=birmingham" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

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

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

Terminal by Alpha Code

Look up a single Estes terminal by its unique alpha code (e.g., BHM, LRK).

Path Parameters

Parameter	Type	Description
`code` required	`string`	2-4 letter terminal alpha code

Code Examples

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

{
  "success": true,
  "location": {
    "id": 1,
    "alphaCode": "BHM",
    "terminalNumber": 43,
    "terminalName": "Birmingham",
    "address": { ... },
    "contact": { ... }
  }
}

GET /api/estes-location/coverage

Estes Coverage Statistics

Returns aggregate statistics: total terminals, breakdown by state and country.

Code Examples

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

{
  "success": true,
  "totalLocations": 274,
  "byState": [
    { "state": "AL", "count": 4 },
    { "state": "AR", "count": 3 },
    ...
  ],
  "byCountry": [
    { "country": "CA", "count": 37 },
    { "country": "US", "count": 237 }
  ]
}

POST /api/estes-location/batch

Batch State Lookup

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

Request Body

Parameter	Type	Description
`states` required	`string[]`	Array of 2-letter state codes (max 10)

Code Examples

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

{
  "success": true,
  "results": {
    "AL": { "total": 4, "locations": [ ... ] },
    "CA": { "total": 23, "locations": [ ... ] },
    "TX": { "total": 17, "locations": [ ... ] }
  },
  "summary": { "statesRequested": 3, "totalLocations": 44 }
}