Fedex Logo
Developer Portal

FedEx Locations Search API

소개

FedEx 접수처는 FedEx 발송 제공자가 관리하는 픽업 및 방문 접수 지점입니다. FedEx 운송업체를 이용해 패키지를 픽업 장소에서 방문 접수처로 발송할 수 있습니다. 이 API는 주소, 지리 좌표 또는 전화번호를 사용해 이용 가능한 발송 접수처를 검색할 수 있도록 도와줍니다.

FedEx 접수처 검색 API는 FedEx 오피스® 인쇄 발송 센터 그리고 FedEx Express®, FedEx Ground® 패키지 방문 접수를 이용할 수 있는 FedEx Drop Box 접수처 등 가장 가까운 FedEx 패키지 방문 접수처의 주소를 검색해 보여줍니다.

FedEx 접수처 검색 API 세부정보

FedEx 접수처 검색 API는 주소, 지리 좌표 또는 전화번호를 사용해 FedEx 방문 접수처를 검색할 수 있도록 도와줍니다.

또한 FedEx 접수처 검색 API를 통해 다음에 해당하는 접수처를 검색할 수도 있습니다.

  • 공인 발송 센터
  • 공인 방문 접수 센터
  • FedEx 접수처에 보관
  • 드롭 박스 접수처
  • 위험물 화물을 허용하는 접수처

FedEx 접수처 검색 API는 다음의 기능을 포함합니다.

  • 가장 가까운 FedEx 픽업 및 방문 접수처 검색
  • 우편번호, 국가 코드 등을 포함한 접수처 상세 주소 검색

FedEx 접수처 검색 API 활용 방법

접수처 검색 API로 FedEx Express® 및 FedEx Ground® 패키지 방문 접수를 이용할 수 있는 FedEx 접수처를 알아볼 수 있습니다. 이 트랜잭션은 가장 가까운 FedEx 접수처의 주소를 찾아서 보여줍니다. 또한 이 API를 사용해 FedEx 접수처에 보관 서비스를 제공하는 FedEx 접수처를 찾을 수 있습니다.

접수처 찾기

이 요청은 입력한 세부 정보를 기반으로 이용 가능한 모든 접수처 목록을 반환합니다. 이 요청과 관련된 주요 입력 정보는 다음과 같습니다.

  • 위치 주소
  • 거리(FedEx 접수처 검색 대상 주소를 기준으로 한 반경 거리 값 및 단위)

참고: 우편번호 사용 국가의 경우 우편번호 입력이 필수입니다. 우편번호를 사용하지 않는 국가의 경우에는 도시 및 국가의 조합을 통해 유효한 FedEx 접수처를 찾습니다.

이 요청의 결과로 거리, 영업 시간, 운송업체 세부 정보, 평일 중 이용 가능한 접수처 서비스 및 역량, 발송물 방문접수/픽업 가능 여부, 픽업을 위한 발송물 보관 가능 여부 등의 주요 정보를 비롯해 이용 가능한 모든 FedEx 픽업 및 방문 접수처의 상세 목록을 확인할 수 있습니다.

FedEx 접수처 검색 API 주요 기능

접수처별 검색으로 검색 결과의 범위를 좁히십시오.

접수처 유형을 사용해 검색 결과의 범위를 줄일 수 있습니다. 검색 요청 시에는 다음과 같은 단일, 복수 유형 또는 모든 유형의 FedEx 접수처를 지정할 수 있습니다.

  • FedEx Authorized ShipCenter® 접수처: 전체 미국 매장 중 독립적으로 소유 및 운영되는 5,800여 개 포장 및 발송 접수처(FASC)를 통해 FedEx 운송 네트워크를 이용하고, 기타 다른 업무 서비스도 제공하는 FedEx Authorized ShipCenter 프로그램에 참여할 수 있습니다. FedEx Authorized ShipCenter 접수처의 경우 FedEx 공식 운임 외에 추가 수수료가 청구될 수도 있습니다.
  • FedEx ShipCenter®
  • Express 사무소
  • FedEx ShipSite
  • FedEx Office® 접수처
  • FedEx 셀프 서비스 접수처: FedEx Express® Drop Box에서 FedEx Express 및 FedEx Ground 패키지(최대 20” x 12” x 6”)를 방문 접수할 수 있습니다.
  • 다음 유형의 접수처에서는 FedEx 접수처에 보관 서비스가 지원됩니다.
    • FedEx OnSite – FedEx Express 및 FedEx Ground 패키지
    • FedEx 오피스 – FedEx Express 및 FedEx Ground 패키지
    • Express 사무소 – FedEx Express 패키지 전용
    • FedEx 발송 센터 – FedEx Express, FedEx Ground 패키지 및 승인된 위험물

접수처 특성

또한 검색 요청을 통해 접수처가 FedEx Express 또는 FedEx Ground 배송지 변경 보관 서비스를 지원하는지 여부를 확인할 수 있으며, 다음과 같은 접수처 특성도 확인할 수 있습니다.

  • 반송 서비스
  • Ground 방문 접수
  • 현금
  • 포장 및 발송
  • 포장 용품
  • 서명 및 배너 서비스
  • Sony PictureStation
  • 다이렉트 메일 서비스
  • 복사 및 인쇄 서비스
  • 위험물 서비스
  • 공항 내 접수처
  • 공증 서비스
  • 서머 타임(일광 절약 시간) 준수
  • 여권 사진 서비스
  • 드롭 박스
  • 국내 발송 서비스
  • 국제 발송 서비스

결과 정렬

FedEx 접수처 검색 API에서는 다음으로 결과를 정렬할 수 있습니다.

  • 가장 늦은 FedEx Express 방문 접수 시간
  • 가장 늦은 FedEx Ground 방문 접수 시간
  • 접수처 유형
  • 거리 오름차순
  • 거리 내림차순

추가 검색 기준

다음 기준을 통해 검색 결과의 범위를 줄일 수 있습니다.

  • 토요일 배송 서비스 이용 가능
  • 포장 서비스 이용 가능
  • 포장재 이용 가능(FedEx Ground 포장재를 제외한 FedEx Express 포장재가 제공되는 곳)
  • 가장 늦은 FedEx Express 방문 접수처: 가장 늦은 시간에 방문 접수가 가능한 인근 접수처를 찾아 보여줍니다.
  • Express 방문 접수 후: 오후 5시와 같이 특정 시간 이후에 패키지를 방문 접수하려면, 이 조건을 사용하여 5시 이후에도 운영되는 방문 접수처를 검색합니다.

참고: FedEx 접수처 검색 API는 주소지를 기준으로 반경 50마일(약 80.5km) 내에 위치한 접수처를 최대 75개까지 보여줍니다.

FedEx 접수처

FedEx Ship Center® 접수처: 패키지를 방문 접수하고 발송 정보를 확인할 수 있습니다.

FedEx Ship Center 접수처에서 발송 전문가의 도움으로 배송 서비스를 선택하고, 서류를 작성하고, 패키지 발송을 처리할 수 있습니다. 또한 고객님의 일정 편의를 위해 많은 접수처가 평일 저녁 늦은 시간과 토요일에도 운영됩니다.

  • 발송물을 직접 방문 접수하거나, FedEx가 고객님을 대신해 카운터에서 발송 처리를 도와드립니다.
  • 박스 및 기타 포장재를 구입할 수 있습니다.
  • FedEx 방문 접수처에서 토요일 배송 서비스 등 각 접수처에서 제공하는 서비스 목록을 확인하십시오.
  • 요금의 경우 고객님의 FedEx 고객번호로 청구하거나, 대부분의 접수처에서 수표, 신용카드 또는 현금으로 지불할 수 있습니다.

참고: FedEx Ship Center 및 다른 FedEx 발송 접수처에서 FedEx International Ground® 패키지를 발송하려면 FedEx 고객번호가 필요합니다.

FedEx Authorized ShipCenter® 접수처: 독립적으로 소유 및 운영되는 포장 및 발송(pack-and-ship) 접수처입니다.

FedEx Authorized ShipCenter® 접수처에 방문해 포장 및 발송 서비스를 이용해보십시오. 또한 팩스 전송, 복사 등의 비즈니스 서비스도 함께 이용하실 수 있습니다.

  • 제휴 우편 비즈 센터 및 제휴 발송업체와 제휴되어 있는 접수처 뿐만 아니라 AIM Mail Center®, PakMail®, PostalAnnex+®, PostNet®과 같은 포장 및 발송(pack-and ship) 제휴 접수처를 찾아보십시오.
  • 대부분의 제휴 접수처에서 FedEx Express와 FedEx Ground 모두 발송 가능합니다. 자세한 내용은 FedEx 방문 접수처를 확인하시기 바랍니다.

참고: 패키지 발송 처리 요금은 각 접수처의 자체 요금 정책을 따릅니다. 이러한 유형의 접수처에서 서비스를 이용하는 경우 FedEx 기본 운임 외에 추가 수수료가 청구될 수 있습니다.

Office Depot®의 FedEx ShipSite 및 OfficeMax® 접수처 : 발송 서비스에 편리하게 접근할 수 있습니다.

Office Depot와 OfficeMax 접수처에서 FedEx®서비스를 이용할 수 있습니다. 이러한 유형의 접수처는 FedEx Express, FedEx Ground 미국, 국제 발송 서비스를 제공하며, 고객은 패키지를 방문 접수하거나 카운터에서 패키지 발송을 처리하고, 포장재를 구입하거나 다른 필요한 업무를 보는 등 하나의 장소에서 모든 서비스를 한 번에 이용할 수 있습니다.

FedEx Drop Box 접수처: 35,000여 개의 접수처

사무실 빌딩, 쇼핑몰, 공항, FedEx 오피스 접수처, 식료품점을 비롯한 편리한 장소에 35,000여 개의 드롭 박스가 자리하고 있습니다.

  • FedEx Express, FedEx Ground 및 FedEx Ground® Economy(이전 명칭: FedEx SmartPost®) 발송물을 방문 접수하십시오. FedEx Ground 발송물의 경우에는 배송에 하루가 더 소요될 수 있습니다.
  • 모든 드롭 박스에서 허용하는 패키지 크기는 최대 20인치 x 12인치 x 6인치까지입니다(대다수의 경우 최대 20인치 x 12인치 x 9인치까지 허용).
  • 대부분의 경우 한정된 수량의 FedEx Express 항공운송장 및 포장재를 구비하고 있습니다.
  • 모든 발송물은 월요일에서 금요일까지 픽업이 가능하며 일부는 토요일에도 픽업이 가능합니다.
  • FedEx SameDay® 패키지는 드롭 박스를 이용할 수 없습니다.
  • IATA 섹션 II 리튬 배터리 및 생물학 물질, 카테고리 B(UN 3373)에 해당하는 위험물만 드롭 박스를 이용할 수 있습니다.
  • 현금, 수표 또는 신용카드를 사용한 결제가 불가합니다.

FedEx OnSite 접수처: 쇼핑한 곳에서 픽업 및 방문 접수가 가능합니다.

FedEx OnSite 접수처를 이용하면 가장 편리한 곳에서 FedEx 패키지를 픽업 및 방문 접수할 수 있습니다. FedEx OnSite 접수처는 고객이 일하고, 거주하고, 여가를 즐기는 곳 가까이에 위치하며 일부는 늦은 시간까지 연장 운영을 하기도 합니다. FedEx는 미국 및 푸에르토리코에 약 9,000개의 Walgreens 접수처 및 일부 특정 Dollar General, Albertsons, Kroger 접수처를 가지고 있으며, 이곳에서는 다음의 서비스를 이용할 수 있습니다.

  • 편한 시간에 픽업할 수 있도록 패키지를 안전한 접수처에 보관할 수 있습니다.
  • 사전에 포장 및 라벨링이 완료된 FedEx Express 발송물, FedEx Ground 미국 발송물, 국제 발송물을 방문 접수할 수 있습니다. 개별 패키지의 중량은 최대 55파운드(약 25kg)까지 허용되며, 크기는 길이 48인치, 폭 25인치, 높이 25인치까지 허용됩니다.

비즈니스 규칙

  • FedEx 오피스 접수처, FedEx OnSite 접수처 및 특정 FedEx Authorized ShipCenter는 위험물, 살아있는 동물, 담배 또는 기타 규제 대상 물품 및 위험 물질을 허용하지 않습니다.
  • 접수처 유형에 따른 중량 제한
    • FedEx 오피스 및 FedEx Ship Center 접수처는 특정 FedEx Authorized ShipCenter 접수처와 FedEx OnSite 접수처의 기준보다 더 크고 무거운 패키지를 FedEx 접수처에 보관하도록 허용할 수도 있습니다.
    • FedEx Ship Center 접수처는 중량 150파운드(약 68kg), 길이 119인치 및/또는 165인치 그리고 둘레(길이+두 폭+두 높이)를 초과하는 패키지가 다른 지점으로 배송될 수 있도록 허용합니다.
    • FedEx 오피스 접수처는 최대 중량 150파운드(약 68kg), 최대 길이 119인치 및/또는 165인치 그리고 둘레(길이+두 폭+두 높이)에 해당하는 패키지를 허용합니다.
    • FASC 및 FedEx OnSite(예: Walgreens) 접수처는 최대 중량 55파운드(약 25kg), 최대 크기 48인치 x 25인치 x 25인치에 해당하는 패키지를 허용합니다.

JSON API 컬렉션

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