Developer Reference
GLS US Drop Box Lookup
Find any of GLS US’s 535 drop box locations by state, ZIP, or city - with GPS coordinates, pickup times, and location notes. Free to use, plus a REST API for batch lookups and coverage from your own app.
/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 YOUR_API_KEY"/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) |
Response Fields
| Field | Type | Description |
|---|---|---|
success
|
boolean
|
Indicates whether the request succeeded |
query
|
string
|
The search query echoed back |
dropboxes[].id
|
integer
|
Internal drop box ID |
dropboxes[].address
|
string
|
Street address |
dropboxes[].city
|
string
|
City |
dropboxes[].state
|
string
|
2-letter state code |
dropboxes[].zip
|
string
|
ZIP code |
dropboxes[].coordinates
|
object
|
{ latitude, longitude } |
dropboxes[].pickupTime
|
string
|
Daily pickup time |
dropboxes[].locationNotes
|
string
|
Free-text location notes |
total
|
integer
|
Total number of matching drop boxes |
currentPage
|
integer
|
Current page number |
totalPages
|
integer
|
Total number of pages |
Code Examples
curl "https://freightapis.dev/api/gls-location/search?q=beverly" \
-H "Authorization: Bearer YOUR_API_KEY"/api/gls-location/coverage
GLS Coverage Statistics
Returns aggregate statistics: total drop boxes and breakdown by state.
Response Fields
| Field | Type | Description |
|---|---|---|
success
|
boolean
|
Indicates whether the request succeeded |
totalLocations
|
integer
|
Total number of GLS drop boxes |
byState
|
array
|
[ { state, count } ] |
Code Examples
curl "https://freightapis.dev/api/gls-location/coverage" \
-H "Authorization: Bearer YOUR_API_KEY"/api/gls-location/batch
Batch State Lookup
Retrieve drop boxes 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 2-letter state 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, dropboxes[] } keyed by 2-letter state code |
summary
|
object
|
Aggregate counts for the request |
Code Examples
curl -X POST "https://freightapis.dev/api/gls-location/batch" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"states": ["CA", "AZ", "NV"]}'GLS US Drop Boxes - FAQ
How do I find a GLS US drop box?
Search by state, ZIP code, or city. FreightAPIs covers all 535 GLS US drop box locations and returns GPS coordinates, pickup times, and location notes instantly - free to use, with a REST API for programmatic and batch queries.
Is the GLS US drop box lookup free?
Yes. Drop box lookup is free for all plans. The Free tier includes 20 API calls per month; paid plans raise the monthly quota for higher-volume queries.
How many GLS US drop boxes are covered?
FreightAPIs covers 535 GLS US parcel drop box locations across the United States, with batch lookups of up to 20 items per request (50 for Enterprise).