An update is scheduled to the FedEx Developer Portal on January 18, 2025, from 8:00PM to 10:00PM CST

and the portal will be unavailable during this time.

Fedex Logo
Developer Portal

FedEx Locations Search API

Introduction

FedEx locations are pickup and dropoff points managed by FedEx shipping providers. You can ship a package from a pickup to a dropoff location using any FedEx carrier. This API helps you to search for supported and available shipping locations using address, geographic coordinates, or phone number.

FedEx Location Search API searches for and returns the addresses of the nearest FedEx package dropoff locations, including FedEx Office® Print and Ship Centers and FedEx Drop Box locations available for FedEx Express® and FedEx Ground® package dropoff.

FedEx Locations Search API Details

The FedEx Locations Search API lets you search for FedEx dropoff locations by address, geographic coordinates, or phone number.

FedEx Locations Search API allows you to search locations based on the following:

  • Authorized shipping centers
  • Authorized dropoff centers
  • Hold at Locations
  • Drop box locations
  • Locations that accept dangerous goods shipments

Features of the FedEx Locations Search API include:

  • Search for the nearest FedEx pickup and dropoff location
  • Retrieve the location’s detailed address, including postal code, country code, etc.

How FedEx Locations Search API Works

The Location Search API helps to request FedEx locations available for FedEx Express® and FedEx Ground® package drop-off. This transaction searches for and returns the addresses of the nearest FedEx location. You can also use this API to find FedEx locations that provide Hold at Location service.

Find Locations

This request is used to return a list of all available locations based on input details. The key input information associated with this request is:

  • Location address
  • Distance (value and units of the radius around the address to search for FedEx locations)

Note: The postal code is mandatory for postal-aware countries. For non-postal-aware countries, a combination of city and country will fetch the valid FedEx locations.

The result of this request is a detailed list of all FedEx pickup and dropoff locations available along with key information such as distance, store hours, carrier details, location service and capabilities available for the weekdays, ability to drop off/pick up shipments, ability to hold shipments for pickup, etc.

FedEx Locations Search API Key Features

Narrow your search by location

You can narrow your search by type of location. One, multiple, or all types of FedEx locations listed may be specified in the search request:

  • FedEx Authorized ShipCenter® locations: Access the FedEx transportation network at over 5,800 independently owned and operated pack and ship locations (FASC) across the U.S. Stores participating in the FedEx Authorized ShipCenter program also provide other business services. FedEx Authorized ShipCenter locations may apply additional charges to the FedEx published rates.
  • FedEx ShipCenter®
  • Express Station
  • FedEx ShipSite
  • FedEx Office® location
  • FedEx self-service location: Drop off FedEx Express and FedEx Ground packages (up to 20” x 12” x 6”) at a FedEx Express® Drop Box.
  • The following location types are supported for the service Hold at Location:
    • FedEx OnSite – FedEx Express and FedEx Ground packages
    • FedEx Office – FedEx Express and FedEx Ground packages
    • Express stations – Only FedEx Express packages
    • FedEx Ship centers – FedEx Express and FedEx Ground packages and approved dangerous goods

Location Capabilities

Additionally, the search request supports an attribute to specify that the locations support FedEx Express or FedEx Ground Redirect to Hold capability and attributes to specify capabilities at the location such as:

  • Return services
  • Ground dropoffs
  • Cash
  • Pack and ship
  • Packaging supplies
  • Signs and banners service
  • Sony PictureStation
  • Direct mail services
  • Copy and print services
  • Dangerous goods services
  • Location is in airport
  • Notary services
  • Observes daylight saving times
  • Passport photo services
  • Drop box
  • Domestic shipping services
  • International shipping services

Sort Results

The FedEx Location Search API lets you to sort the results by:

  • Latest FedEx Express dropoff time
  • Latest FedEx Ground dropoff time
  • Location type
  • By distance in ascending order
  • By distance in descending order

Additional Search Criteria

You may also narrow your search by the following:

  • Saturday service available.
  • Packing service available (most FedEx Office locations): FedEx will pack your shipment for you (at an extra charge).
  • Packing supplies available (anywhere FedEx Express packing materials are supplied; does not include FedEx Ground materials).
  • Latest FedEx Express dropoff locations: Returns locations with the latest dropoff time near you.
  • Express dropoff after: Drop a package off after a specific time, such as 5 p.m. Use this element to search for dropoff locations open after 5 p.m.

Note: The FedEx Location Search API returns up to 75 locations within a 50-mile radius of your address

FedEx Locations

FedEx Ship Center® locations: Drop off packages and get shipping information

The shipping specialists at FedEx Ship Center locations can help you choose a delivery service, complete documentation, and process your packages. Many locations are open late and on Saturdays to accommodate your schedule.

  • Drop off your shipments, or FedEx will process them for you at the counter.
  • Purchase boxes and other packaging supplies.
  • Check the FedEx Dropoff Locator for the list of services, such as Saturday service, offered at each location.
  • Charge your shipments to your FedEx account, or use checks, credit cards, or cash, which are accepted at most locations.

Note: You must have a FedEx account number to ship FedEx International Ground® packages at a FedEx Ship Center and our other shipping locations.

FedEx Authorized ShipCenter® locations: Independently owned pack-and-ship locations

Stop by these independently owned locations for packaging and shipping services. Most also offer faxing, copying, and other business services.

  • Look for pack-and-ship retailers such as AIM Mail Center®, PakMail®, PostalAnnex+®and PostNet®, as well as locations affiliated with the Association of Mail and Business Centers and Retail Shipping Associates.
  • You can ship both FedEx Express and FedEx Ground packages at most of these locations. For more information, check the FedEx Dropoff Locator.

Note: Rates for processing packages reflect each location's own pricing policies. These locations may apply additional charges to FedEx rates.

FedEx ShipSite at Office Depot® and OfficeMax® locations: Convenient access to shipping services

FedEx® Services are available at all Office Depot and OfficeMax locations. These locations offer FedEx Express and FedEx Ground U.S. and international shipping services, so you can drop off packages or process them at the counter, purchase packaging supplies, and handle other business needs, all at one convenient place.

FedEx Drop Box locations: More than 35,000 locations

There are more than 35,000 drop boxes in office buildings, shopping malls, airports, FedEx Office locations, grocery stores, and other convenient locations.

  • Drop off your FedEx Express, FedEx Ground and FedEx Ground® Economy (Formerly known as FedEx SmartPost®) shipments. FedEx Ground shipments may require an additional day for delivery.
  • All drop boxes accept packages up to 20\" x 12\" x 6\" (many accept packages up to 20\" x 12\" x 9\").
  • Most have a limited quantity of FedEx Express airbill and packaging supplies.
  • All offer Monday–Friday pickup, and some also offer pickup on Saturdays.
  • Do not place FedEx SameDay® packages in drop boxes.
  • IATA Section II lithium batteries and Biological Substance, Category B (UN 3373) are the only dangerous goods that may be placed in drop boxes.
  • No cash, check, or credit card payments are accepted.

FedEx OnSite locations: Pick up and drop off where you shop

With FedEx OnSite locations, you can pick up and drop off your FedEx packages where it's most convenient for you. They're close to where you work, live, and play, and some are even open for extended hours. FedEx has nearly 9,000 Walgreens locations and select Dollar General, Albertsons and Kroger locations in the U.S. and Puerto Rico where you can:

  • Have packages held in a secure location for you to pick up at your convenience.
  • Drop off prepackaged, prelabeled FedEx Express and FedEx Ground U.S. and international shipments. Individual packages can weigh up to 55 lbs. and measure up to 48″ in length by 25\" in width by 25\" in height.

Business Rules

  • FedEx Office locations, FedEx OnSite locations, and select FedEx Authorized ShipCenter do not accept dangerous goods, live animals, tobacco, or other regulated material and hazardous shipments.
  • Weight Restrictions by Location Type
    • FedEx Office and FedEx Ship Center locations may accept larger and heavier Hold at Location packages than select FedEx Authorized ShipCenter location and FedEx OnSite locations.
    • FedEx Ship Center locations accept packages exceeding 150 lbs., 119″ length, and/or 165\" length and girth (L+2W+2H) that cannot be delivered to other locations.
    • FedEx Office locations accept packages with a maximum weight of 150 lbs., maximum length of 119″ and/or 165″ length and girth (L+2W+2H).
    • FASCs and FedEx OnSite (e.g., Walgreens) locations accepts packages with a maximum weight of 55 lbs. and maximum size of 48\" x 25\" x 25\".

JSON API Collection

FedEx Location Search API (1.0.0)

Find Locations

Use this endpoint to search for nearest FedEx locations by address, geographicccc coordinates, or phone numberrrr. You can also narrow your search by type of location and services offered. It returns up to 75 locations within a 50-mile radius for the address used in the search criteria. Results are based on current date and time. Supports all FedEx operating companies and countries, dependent upon being able to get a valid geolocation for a given set of criteria.
Note: You must specify landline numbers only, when searching for the nearest FedEx locations using phone number.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.

header Parameters
x-customer-transaction-id
string
Example: 624deea6-b709-470c-8c39-4b5511281492

This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply.

content-type
required
string
Example: application/json

This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file.

x-locale
string
Example: en_US

This indicates the combination of language code and country code. Click here to see Locales

authorization
required
string
Example: Bearer XXX

This indicates the authorization token for the input request.

Request Body schema: application/json
One of
  • Full_Schema_Find_Location
  • Search_Location_for_Postal_Aware_Country
  • Search_Location_for_Non_Postal_Aware_Country
  • Search_Location_by_US_domestic_Postal_Address
  • Search_Location_by_International_Postal_Address
  • Search_Location_by_Geographic_Coordinates
  • Search_Location_by_Phone_Number
  • Search_Location_HOLD_AT_LOCATION
  • Search_Location_OFFICE_AND_ONSITE
  • Search_Location_by_RETURNS_SERVICES
locationsSummaryRequestControlParameters
object

Use this object to specify all the inputs to get the locations details.

constraints
object

Specify the constraints to be applied to the location attributes.

locationSearchCriterion
string
Enum: "ADDRESS" "GEOGRAPHIC_COORDINATES" "PHONE_NUMBER"

Specify the criteria to be used to search for FedEx locations. Default value is ADDRESS if no value is passed.

Valid values:

  • ADDRESS – Search by address. Location detail data is required.
  • GEOGRAPHIC_COORDINATES – Search by geocodes. Location geocodes are required.
  • PHONE_NUMBER – Search by phone number. Location Phone number is required.

Note: Country code is REQUIRED when searching by any of the LocationsSearchCriterion, even PhoneNumber and GeorgraphicCoordinates.

location
required
object

Based on the locationSearchCriterion value specified, the location element specifies the minimum requirement for address search like postalCode, countryCode, GeoCodes or city.Location phone number is required. Only landline number is allowed.

Note: Country code is REQUIRED for the search.

phoneNumber
string

Specify the phone number(Only LandLine allowed) if the locationSearchCriterion is set to 'PHONE_NUMBER'.Given that is the case, the location search will be made based on the phone number value and the location object(postalCode&countryCode) will be completely ignored.
Example: 9015551234

multipleMatchesAction
string
Enum: "RETURN_ALL" "RETURN_ERROR" "RETURN_FIRST"

Specify the criterion to be used to return location results when there are multiple matches.
Valid values: RETURN_ALL,RETURN_ERROR, RETURN_FIRST.

Note: The 'maxResults' value takes precedence over RETURN_ALL value.

sort
object (Sort)

Specifies how the location search results will be sorted in the reply.

trackingInfo
object (TrackingInfo)

Information uniquely identifying a shipment such as Tracking number, ShipDate, and Tracking number uniqueId. This tracking information helps to return the correct list of locations when REDIRECT_TO_HOLD_AT_LOCATION is requested

sameState
boolean

Filter to display locations within the same state as the search criteria.
Valid values: True, False.

sameCountry
boolean

Filter to display locations within the same country as the search criteria.
Valid values: True, False.

redirectToHoldType
string
Enum: "FEDEX_EXPRESS" "FEDEX_GROUND" "FEDEX_GROUND_HOME_DELIVERY"

Specify the type of service supported by a FedEx location for redirect to hold.

locationAttrTypes
Array of strings
Items Enum: "ACCEPTS_CASH" "FEDEX_RETURNS_TECHNOLOGY" "ALREADY_OPEN" "COPY_AND_PRINT_SERVICES" "DANGEROUS_GOODS_SERVICES" "DIRECT_MAIL_SERVICES" "LOCATION_IS_IN_AIRPORT" "NOTARY_SERVICES" "OPEN_TWENTY_FOUR_HOURS" "PACK_AND_SHIP" "PACKAGING_SUPPLIES" "PASSPORT_PHOTO_SERVICES" "RETURNS_SERVICES" "SIGNS_AND_BANNERS_SERVICE" "SONY_PICTURE_STATION" "DROP_BOX" "DOMESTIC_SHIPPING_SERVICES" "INTERNATIONAL_SHIPPING_SERVICES" "CLEARANCE_SERVICES"

Specify attributes to filter location types. If more than one value is specified, only those locations that have all the specified attributes will be returned.
Note: In order to filter for DROP_BOX location, need to add locationTypes as FEDEX_SELF_SERVICE_LOCATION

locationCapabilities
Array of objects (LocationCapabilities)

Specify to filter the locations based on their capabilities.

packageAttributes
Array of objects (PackageAttribute)

Specify location supported package constraints to narrow the search.

For example, a package weighing more than 151 pounds may not be supported at all location types. Drop box location would be excluded.

Note: The package attributes inputs are only recognized/supported for FedEx OnSite Locations.

locationTypes
Array of strings
Items Enum: "FEDEX_AUTHORIZED_SHIP_CENTER" "FEDEX_OFFICE" "FEDEX_SELF_SERVICE_LOCATION" "FEDEX_ONSITE" "FEDEX_EXPRESS_STATION" "FEDEX_SHIPSITE" "FEDEX_SHIP_AND_GET"

Results filter which narrows the search to specific types of FedEx Locations.

includeHoliday
boolean

Indicates true if the location holiday list is desired in the results; otherwise false
Valid values: True, False.

dropoffTime
string

Specifies the latest time by which you can drop-off a package at a location to process the shipment the same day. This limits the results to locations that support a specific drop-off time. The format is an ISO 8601 string in which only the time portion is used.
Example: 16:00:00

dropOffServiceType
string

The drop-off service types supported by the specified location. If sort criteria is given as LATEST_EXPRESS_DROPOFF_TIME and dropoffservicetype is GROUND then backend will take the SORT_BY_LATEST_GROUND_TIME as sort criteria.
Example: FedEx Ground.

carrierCodes
Array of strings
Items Enum: "FDXE" "FDXG"

Unique code to identify the transporter.

getCall
boolean

Get a call.
Valid values: True, False.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /location/v1/locations

Sandbox Server

https://apis-sandbox.fedex.com/location/v1/locations

Production Server

https://apis.fedex.com/location/v1/locations

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "locationsSummaryRequestControlParameters":
    {
    },
  • "constraints":
    {
    },
  • "locationSearchCriterion": "ADDRESS",
  • "location":
    {
    },
  • "phoneNumber": "9015551234",
  • "multipleMatchesAction": "RETURN_ALL",
  • "sort":
    {
    },
  • "trackingInfo":
    {
    },
  • "sameState": true,
  • "sameCountry": true,
  • "redirectToHoldType": "FEDEX_GROUND",
  • "locationAttrTypes":
    [
    ],
  • "locationCapabilities":
    [
    ],
  • "packageAttributes":
    [
    ],
  • "locationTypes":
    [
    ],
  • "includeHoliday": true,
  • "dropoffTime": "09:30:00",
  • "dropOffServiceType": "GROUND",
  • "carrierCodes":
    [
    ],
  • "getCall": false
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  • "customerTransactionId": "AnyCo_order123456789",
  • "output":
    {
    }
}
CLOSE

Response

Copy