{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/pick-up-drop-off/find-service-points","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/pick-up-drop-off/find-service-points","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/pick-up-drop-off/find-service-points","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Find Service Points","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"find-service-points","__idx":0},"children":["Find Service Points"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipStation API offers two methods to find service points and their associated details:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List service points"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/service_points/list"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Lists all available service points for the carrier with their service point ID and related details. This method relies on either the address or latitude and longitude as the reference point and allows you to refine your results by indicating a distance radius in kilometers."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Get service point by ID"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/service_points/{carrier_code}/{country_code}/{service_point_id}"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Returns the service point details of a specific service point. This method relies on adding the carrier code, country code, and service point ID as path parameters to the endpoint."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are new to using service points, review our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/pick-up-drop-off/pudo-intro"},"children":["Introduction to Service Points"]}," and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/pick-up-drop-off/create-pudo-labels"},"children":["Create PUDO Labels"]}," pages to learn more about using service points with ShpEngine."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The service points endpoint is available only to accounts on an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://help.shipengine.com/hc/en-us/articles/19326509952027"},"children":["Advanced plan or higher"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"service-points-properties","__idx":2},"children":["Service Points Properties"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required?"},"children":["Required?"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address_query"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔  *"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unstructured address text to search for service points. (EX: 123 Any St, Austin, TX)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔  *"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Object"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When used, you must provide the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_code"]}," and at least one other address property (Ex: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_code"]},"). The more fields you enter, the more accurate your results will be."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A required property in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," object. Use the 2-character ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1"},"children":["ISO 3166-1 country code"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["providers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Array of Objects"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The array of carriers and service codes to be included in the search for service points. This object includes the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_code"]}," properties."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Property to include in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["providers"]}," array. Requires at least one, but can include multiple carriers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can include a single service code or multiple. For multiple, separate each with a comma."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lat"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔  *"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["number ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<double>"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The latitude of the service point, represented as signed degrees. Required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["long"]}," is provided. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"http://www.geomidpoint.com/latlon.html"},"children":["Latitude & Longitude Formats"]}," for lat/long format details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["long"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔  *"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["number ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<double>"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The longitude of the service point, represented as signed degrees. Required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lat"]}," is provided. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"http://www.geomidpoint.com/latlon.html"},"children":["Latitude & Longitude Formats"]}," for lat/long format details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["radius"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search radius in kilometers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_results"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The maximum number of service points to list in the response. Default is 100."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["object"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shipment information to use for service point selection. Includes the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total_weight"]}," object and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["packages"]}," array."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total_weight"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["object"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The total weight of the shipment. Requires  the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}," property (",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["number"]},") and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unit"]}," property (",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["ennumerated string"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pound"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ounce"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gram"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kilogram"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["packages"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["array"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An array of package dimensions. Includes the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dimensions"]}," object, which requires the following properties: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unit"]}," (",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["ennumerated string"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inch"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["centimeter"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["length"]}," (",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["number"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["width"]}," (",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["number"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["height"]}," (",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["number"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["* ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Whether certain properties will be required in your request body will depend on which option you use to find service points. Review the List Service Points options and examples in the next section."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"list-service-points","__idx":3},"children":["List Service Points"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You have three options for finding service points using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/service_points/list"]}," method."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find by latitude and longitude"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find by address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find by address string"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can filter the results provided in the response by including the following optional properties in your request:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_code"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["radius"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_results"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Additionally, if you include service codes in your request, the response will indicate which ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_code"]}," relates to which service point."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"requirements-1","__idx":4},"children":["Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every request must include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["providers"]}," object with at least the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-carriers"},"children":["list your carriers"]}," to find your carrier IDs)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition, the following properties are required based on the option you are using the find service points:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find by latitude and longitude: requires both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lat"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["long"]}," properties."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find by address: requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_code"]}," and at least one of the following - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addressline_1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city_locality"]},",",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state_province"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postal_code"]}," (the more properties you include, the more accurate your results)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find by address string: requires the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address_query"]}," property."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only use one option at a time to find service points. The request will fail if you attempt to use more than one in a single request. For example, if you include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lat"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["long"]}," properties in your request, do not include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," object or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address_query"]}," property."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-find-by-latitude--longitude","__idx":5},"children":["Example Request: Find by Latitude & Longitude"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example shows how to get a list of service points for a specific carrier and service by providing longitude and latitude values. The request further specifies a radius of 50 km with a maximum of 25 results."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/service_points/list HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"lat\": \"48.8724402\",\n  \"long\": \"2.3120628\",\n  \"providers\": [\n    {\n      \"carrier_id\": \"se-123\",\n      \"service_code\": [\n        \"ups_standard\"\n      ]\n    }\n  ],\n  \"radius\": 50,\n  \"max_results\": 25\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-find-by-address","__idx":6},"children":["Example Request: Find by Address"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example shows how to get a list of service points for a specific carrier and service by providing an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," object."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/service_points/list HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"address\": {\n    \"address_line1\": \"3800 North Lamar\",\n    \"address_line2\": \"Suite 200\",\n    \"city_locality\": \"Austin\",\n    \"state_province\": \"TX\",\n    \"postal_code\": \"78652\",\n    \"country_code\": \"US\"\n  },\n  \"providers\": [\n    {\n      \"carrier_id\": \"se-123456\",\n      \"service_code\": [\n        \"ups_standard\"\n      ]\n    }\n  ],\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-find-by-address-string","__idx":7},"children":["Example Request: Find by Address String"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example shows how to get a list of service points for a specific carrier and service by providing an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address_query"]}," string. The request further specifies a radius of 50 km with a maximum of 25 results."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/service_points/list HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"address_query\": \"177A Bleecker Street, New York\",\n  \"providers\": [\n    {\n      \"carrier_id\": \"se-123456\",\n      \"service_code\": [\n        \"ups_standard\"\n      ]\n    }\n  ],\n  \"radius\": 50,\n  \"max_results\": 25\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list-service-points-response","__idx":8},"children":["List Service Points Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The list service points response will include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_points"]}," array with multiple properties containing various details about each service point it includes. You can pass these properties through to your own applications to provide your customers with service point options in their checkout. You can also use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_point_id"]}," value in the related PUDO field when ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/pick-up-drop-off/create-pudo-labels"},"children":["creating a PUDO label"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This sample response includes all potential fields that would appear in the response, with sample data."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"lat\": 48.842608,\n  \"long\": 0.032875,\n  \"service_points\": [\n    {\n     \"carrier_code\": \"dhl_express\",\n     \"service_codes\": [\"chronoclassic\"],\n     \"service_point_id\": \"614940\",\n     \"company_name\": \"My fancy company name\",\n     \"address_line1\": \"PLACE DU CANADA\",\n     \"city_locality\": \"TRUN\",\n     \"state_province\": \"TRUN\",\n     \"postal_code\": \"78756-3717\",\n     \"country_code\": \"CA\",\n     \"phone_number\": \"555-555-5555\",\n     \"lat\": 48.842608,\n     \"long\": 0.032875,\n     \"distance_in_meters\": 728.9959308847579,\n     \"hours_of_operation\": {\n      \"monday\": [\n        {\n        \"open\": \"09:15\",\n        \"close\": \"12:00\"\n        }\n      ],\n      \"tuesday\": [\n        {\n        \"open\": \"09:15\",\n        \"close\": \"12:00\"\n        }\n      ],\n      \"wednesday\": [\n        {\n        \"open\": \"09:15\",\n        \"close\": \"12:00\"\n        }\n      ],\n      \"thursday\": [\n        {\n        \"open\": \"09:15\",\n        \"close\": \"12:00\"\n        }\n      ],\n      \"friday\": [\n        {\n        \"open\": \"09:15\",\n        \"close\": \"12:00\"\n        }\n      ],\n      \"saturday\": [\n        {\n        \"open\": \"09:15\",\n        \"close\": \"12:00\"\n        }\n      ],\n      \"sunday\": [\n        {\n        \"open\": \"09:15\",\n        \"close\": \"12:00\"\n        }\n      ]\n      },\n    \"features\": [\"drop_off_point\"],\n    \"type\": \"pudo\"\n    }\n  ],\n  \"errors\": []\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The available ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["features"]}," values are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["drop_off_point"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pick_up_point"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["print_services"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["after_hours_locker"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["after_hours_dropbox"]},". The available ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," values are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pudo"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locker"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If an error occurs, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errors"]}," array will contain the details you need to troubleshoot the issue and change your request body to try again."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_source"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_type"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_code"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_code"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["field_name"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please see the response section of the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://shipengine.github.io/shipengine-openapi/#operation/service_points_list"},"children":["List Service Points method in our full API reference"]}," for the list of potential values for each property."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-service-point-by-id","__idx":9},"children":["Get Service Point by ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you already know the ID of the service point you wish to use or get details for, you can use the GET method with the service points endpoint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response will return the service point location address details, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hours_of_operation"]}," (",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["object"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["features"]}," (",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["array"]},"), and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," (",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["ennumerated string"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"requirements-2","__idx":10},"children":["Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This GET method requires adding the following path parameters to the endpoint:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_code"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_code"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_point_id"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request--response","__idx":11},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/service_points/{carrier_code}/{country_code}/{service_point_id}"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /v1/service_points/{chronopost}/{FR}/{614940} HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\n{\n  \"service_point\": {\n    \"carrier_code\": \"chronopost\",\n    \"service_codes\": [\n      \"string\"\n    ],\n    \"service_point_id\": \"614940\",\n    \"company_name\": \"My fancy company name\",\n    \"address_line1\": \"PLACE DU CANADA\",\n    \"city_locality\": \"TRUN\",\n    \"state_province\": \"TRUN\",\n    \"postal_code\": \"61160\",\n    \"country_code\": \"FR\",\n    \"phone_number\": \"555-555-5555\",\n    \"lat\": 48.842608,\n    \"long\": 0.032875,\n    \"hours_of_operation\": {\n      \"monday\": [\n        {\n          \"open\": \"09:15\",\n          \"close\": \"12:00\"\n        }\n      ],\n      \"tuesday\": [\n        {\n          \"open\": \"09:15\",\n          \"close\": \"12:00\"\n        }\n      ],\n      \"wednesday\": [\n        {\n          \"open\": \"09:15\",\n          \"close\": \"12:00\"\n        }\n      ],\n      \"thursday\": [\n        {\n          \"open\": \"09:15\",\n          \"close\": \"12:00\"\n        }\n      ],\n      \"friday\": [\n        {\n          \"open\": \"09:15\",\n          \"close\": \"12:00\"\n        }\n      ],\n      \"saturday\": [\n        {\n          \"open\": \"09:15\",\n          \"close\": \"12:00\"\n        }\n      ],\n      \"sunday\": [\n        {\n          \"open\": \"09:15\",\n          \"close\": \"12:00\"\n        }\n      ]\n    },\n    \"features\": [\n      \"drop_off_point\"\n    ],\n    \"type\": \"pudo\"\n  }\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Find Service Points","id":"find-service-points","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Service Points Properties","id":"service-points-properties","depth":2},{"value":"List Service Points","id":"list-service-points","depth":2},{"value":"Requirements","id":"requirements-1","depth":3},{"value":"Example Request: Find by Latitude & Longitude","id":"example-request-find-by-latitude--longitude","depth":3},{"value":"Example Request: Find by Address","id":"example-request-find-by-address","depth":3},{"value":"Example Request: Find by Address String","id":"example-request-find-by-address-string","depth":3},{"value":"List Service Points Response","id":"list-service-points-response","depth":3},{"value":"Get Service Point by ID","id":"get-service-point-by-id","depth":2},{"value":"Requirements","id":"requirements-2","depth":3},{"value":"Example Request & Response","id":"example-request--response","depth":3}],"frontmatter":{"seo":{"title":"Find Service Points"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/pick-up-drop-off/find-service-points","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}