Sign in
Shipping Locations

Get Carrier Locations

Retrieves a list of all shipping locations associated with a specific carrier. <br /> <br />Note: A shipping location can be associated with more than one carrier. However, to get the carrier locations, you need to make individual API requests for each carrier.

get/v4/shippingLocations/{carrierCode}

Path parameters

carrierCodestring required

A unique identifier for the carrier associated with the shipping location. This code is alphanumeric and helps in identifying the specific carrier linked to the shipping location.

Query parameters

searchTermstring

A string representing the term or keywords used to filter location results. For example, a search term like "Manchester" would return locations associated with that city, helping to narrow down the list based on the user input.

pageSizeinteger

An integer that defines the number of location entries (record) returned per page in the response. For instance, if pageSize is set to 20, the API will return up to 20 locations in each response. <br /> <br />Note: By default, this value is set to 100.

pageNumberinteger

An integer indicating the specific page of results to retrieve, allowing for pagination of larger datasets. For example, if pageNumber is set to 3, the API will return the results corresponding to the third page of locations based on the specified pageSize. <br /> <br />Note: By default, this value is set to 1.

sortBy'Name'

Sort By

A string specifying the field by which to organise the search results. For instance, "Name" could be used to sort locations alphabetically, arranging the results in a more user-friendly order. <br /> <br />Note: By default, this value is set to Name.

sortDir'Ascending' | 'Descending'

Order Direction

A string indicating the direction in which to sort the results, typically set to "ascending" or "descending." For example, setting sortDir to "Ascending" while using "Name" as sortBy would arrange the locations from A to Z. <br /> <br />Note: By default, this value is set to Ascending.

Response

Returns a paged list of shipping locations linked to accounts for the given carrier.

TotalCountinteger required

An integer representing the total number of shipping locations that match the specified query criteria. This provides users with an overview of how many shipping locations are available on the system, enabling better understanding of the dataset.

Example response

{
  "ShippingLocations": [
    {
      "LocationAlias": "Main Warehouse",
      "Timezone": "Europe/London",
      "LastUpdatedDateUtc": "2022-02-06T16:13:24.010Z",
      "LastUpdatedBy": "User A",
      "Address": {
        "Line1": "Brown Cottage",
        "Line2": "Brown Cottage",
        "Town": "Christchurch",
        "Postcode": "TW20 0HJ",
        "County": "Surrey",
        "CountryCode": "GB",
        "What3Words": "brick.space.employ",
        "ContactPhone": "07123887422"
      }
    }
  ],
  "TotalCount": 303
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.