GLS US Drop Boxes - API Docs

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

GLS Drop Boxes by State or ZIP

Look up GLS US drop box locations by state code or ZIP code. Returns addresses, GPS coordinates, pickup times, and location notes.

Query Parameters

Parameter	Type	Description
`state` optional	`string`	2-letter state code (e.g., CA, NY). 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 drop boxes returned
`dropboxes[].address`	`string`	Street address
`dropboxes[].city`	`string`	City name
`dropboxes[].state`	`string`	State code
`dropboxes[].zip`	`string`	ZIP code
`dropboxes[].coordinates`	`object`	GPS latitude and longitude
`dropboxes[].pickupTime`	`string`	Scheduled pickup time (e.g., "05:00 PM")
`dropboxes[].locationNotes`	`string`	Directions or notes about the drop box location

Code Examples

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

{
  "success": true,
  "state": "CA",
  "total": 285,
  "dropboxes": [
    {
      "id": 1,
      "address": "9200 W Sunset Blvd",
      "city": "West Hollywood",
      "state": "CA",
      "zip": "90069",
      "coordinates": {
        "latitude": 34.089828,
        "longitude": -118.392759
      },
      "pickupTime": "05:00 PM",
      "locationNotes": "Parking level by exit next to other drop box"
    }
  ]
}

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

Search GLS Drop Boxes

Full-text search across addresses, cities, and location notes. 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/gls-location/search?q=beverly" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "query": "beverly",
  "dropboxes": [ ... ],
  "total": 12,
  "currentPage": 1,
  "totalPages": 1
}

GET /api/gls-location/coverage

GLS Coverage Statistics

Returns aggregate statistics: total drop boxes and breakdown by state.

Code Examples

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

{
  "success": true,
  "totalLocations": 535,
  "byState": [
    { "state": "AZ", "count": 15 },
    { "state": "CA", "count": 285 },
    ...
  ]
}

POST /api/gls-location/batch

Batch State Lookup

Retrieve drop boxes 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/gls-location/batch" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"states": ["CA", "AZ", "NV"]}'

{
  "success": true,
  "results": {
    "CA": { "total": 285, "dropboxes": [ ... ] },
    "AZ": { "total": 15, "dropboxes": [ ... ] },
    "NV": { "total": 8, "dropboxes": [ ... ] }
  },
  "summary": { "statesRequested": 3, "totalLocations": 308 }
}