service_points

List service points

Changed on Oct 22, 2026

List carrier service points by location

post/v1/service_points/list

Request

Base URL: https://api.shipengine.com
URL: https://api.shipengine.com/v1/service_points/list
Auth: API key in header API-Key

Request body

address_querystring

Unstructured text to search for service points by.

latnumber double

The latitude of the point. Represented as signed degrees. Required if long is provided. http://www.geomidpoint.com/latlon.html

longnumber double

The longitude of the point. Represented as signed degrees. Required if lat is provided. http://www.geomidpoint.com/latlon.html

radiusinteger

Search radius in kilometers

max_resultsinteger

The maximum number of service points to return

Example request

{
  "address_query": "177A Bleecker Street New York",
  "address": {
    "address_line1": "1999 Bishop Grandin Blvd.",
    "postal_code": "78756-3717",
    "country_code": "CA"
  },
  "providers": [
    {
      "carrier_id": "se-123456",
      "service_code": [
        "chronoclassic"
      ]
    }
  ],
  "lat": 48.874518928233094,
  "long": 2.3591775711639404,
  "radius": 500,
  "max_results": 25
}

Response

The request was a success.

latnumber double

The latitude of the point. Represented as signed degrees. Required if long is provided. http://www.geomidpoint.com/latlon.html

longnumber double

The longitude of the point. Represented as signed degrees. Required if lat is provided. http://www.geomidpoint.com/latlon.html

Example response

{
  "lat": 48.842608,
  "long": 0.032875,
  "service_points": [
    {
      "carrier_code": "dhl_express",
      "service_codes": [
        "chronoclassic"
      ],
      "service_point_id": "614940",
      "company_name": "My fancy company name",
      "address_line1": "PLACE DU CANADA",
      "city_locality": "TRUN",
      "state_province": "TRUN",
      "postal_code": "78756-3717",
      "country_code": "CA",
      "phone_number": "555-555-5555",
      "lat": 48.842608,
      "long": 0.032875,
      "distance_in_meters": 728.9959308847579,
      "hours_of_operation": {
        "monday": [
          {
            "open": "09:15",
            "close": "12:00"
          }
        ],
        "tuesday": [
          {
            "open": "09:15",
            "close": "12:00"
          }
        ],
        "wednesday": [
          {
            "open": "09:15",
            "close": "12:00"
          }
        ],
        "thursday": [
          {
            "open": "09:15",
            "close": "12:00"
          }
        ],
        "friday": [
          {
            "open": "09:15",
            "close": "12:00"
          }
        ],
        "saturday": [
          {
            "open": "09:15",
            "close": "12:00"
          }
        ],
        "sunday": [
          {
            "open": "09:15",
            "close": "12:00"
          }
        ]
      }
    }
  ],
  "errors": [
    {
      "error_source": "shipengine",
      "error_type": "validation",
      "error_code": "invalid_field_value",
      "message": "Body of request cannot be null.",
      "carrier_id": "se-28529731",
      "carrier_code": "dhl_express",
      "field_name": "shipment.ship_to.phone_number"
    }
  ]
}

Changes

Oct 22, 2026e998dffc42be Revision changes
- warning
  added the new bring_your_own_label_not_supported enum value to the // response property for the response status
- warning
  added the new bring_your_own_label_not_supported enum value to the // response property for the response status
- warning
  added the new bring_your_own_label_not_supported enum value to the // response property for the response status
- warning
  added the new bring_your_own_label_not_supported enum value to the // response property for the response status
- warning
  added the new multiple_sales_orders enum value to the // response property for the response status
- warning
  added the new multiple_sales_orders enum value to the // response property for the response status
- warning
  added the new multiple_sales_orders enum value to the // response property for the response status
- warning
  added the new multiple_sales_orders enum value to the // response property for the response status
- warning
  added the new sales_order_link_required enum value to the // response property for the response status
- warning
  added the new sales_order_link_required enum value to the // response property for the response status
- warning
  added the new sales_order_link_required enum value to the // response property for the response status
- warning
  added the new sales_order_link_required enum value to the // response property for the response status
Oct 9, 2026020f57d6f5b8 Revision changes
- breaking
  request property //// was restricted to a list of enum values
- breaking
  the // request property's minLength was increased from 0 to 2
- breaking
  the // request property's minLength was increased from 0 to 1
- breaking
  the // request property type changed from no type to string
- breaking
  the // request property type changed from no type to string
- breaking
  the //// request property type changed from no type to string
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the / response's property type changed from no type to object for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- warning
  removed from the // request property allOf list
- warning
  removed from the // request property allOf list
- warning
  removed from the //// request property allOf list
- warning
  the // request property's maxLength was set to 2
- info
  added the new gram enum value to the request property ////
- info
  added the new kilogram enum value to the request property ////
- info
  added the new ounce enum value to the request property ////
- info
  added the new pound enum value to the request property ////
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the / response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  the // response's property pattern ^[a-z0-9]+(_[a-z0-9]+)*$ was added for the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status

Operation history (4 revisions)