Carrier Dropoff and Pickup Locations
Locations are dropoff and pickup points managed by shipping providers. You can ship from and/or to locations with certain carriers. The Shippo API location endpoint allows you to identify those locations based on an address. You can then use those locations for your shipments.
Retrieving Locations
To find carrier locations simply create an address object and make a subsequent API call to retrieve all available locations. Shippo will automatically retrieve all available locations from all carriers that offer locations for this address.
The API will return the following response:
{
"count": 10,
"next": "https://api.goshippo.com/addresses/ad30f58e1e734429b637088d6f1c9202/locations/sync?page=2",
"previous": null,
"results": [
{
"object_created": "2016-11-20T06:48:45.286Z",
"object_updated": "2016-11-20T06:48:45.286Z",
"object_id": "ff14823c538040d0a6aa5860ee8101f3",
"object_owner": "shippotle@goshippo.com",
"address_source": "ad30f58e1e734429b637088d6f1c9202",
"address": {
"is_complete": true,
"object_created": "2016-11-20T06:48:45.274Z",
"object_updated": "2016-11-20T06:48:45.274Z",
"object_id": "88b28566b7eb433cb02573a22bacdd76",
"object_owner": "shippotle@goshippo.com",
"name": "INTERMARCHE CONTACT",
"company": "",
"street_no": "",
"street1": "27 AVENUE DE LA GARE",
"street2": "",
"street3": "",
"city": "AVESNES SUR HELPE",
"state": "",
"zip": "59440",
"country": "FR",
"phone": "0123456789",
"email": "contact@mondialrelay.fr",
"is_residential": null,
"validation_results": {},
"metadata": "FR042145",
"test": null
},
"provider": "Mondial Relay",
"distance_amount": "0.95",
"distance_unit": "km",
"lat": "50.1264681000",
"lng": "3.9319134000",
"further_information": "Horaire:\nLundi: 0900-1200, 1430-1900\nMardi: 0900-1200, 1430-1900\nMercredi: 0900-1200, 1430-1900\nJeudi: 0900-1200, 1430-1900\nVendredi: 0900-1200, 1430-1900\nSamedi: 0900-1200, 1430-1900\nDimanche: fermee\n"
},
...
]
}
Using Locations in Shipments
To use a location for a shipment, simply use the corresponding location’s address
as the address_from
or address_to
in the Shipment request.