---
title: "Get a list of shipping locations"
method: GET
path: "/merchants/{merchantId}/shippingLocations"
tags: ["Terminal orders - merchant level"]
---

# Get a list of shipping locations

`GET /merchants/{merchantId}/shippingLocations`

Returns the shipping locations for the merchant account identified in the path.
A shipping location includes the address where orders can be delivered, and an ID which you need to specify when ordering terminal products.

To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API—Terminal ordering read
* Management API—Terminal ordering read and write

In the live environment, requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).

## Path parameters

- `merchantId` string, required

## Query parameters

- `name` string
- `offset` integer
- `limit` integer

## Response `200`

OK - the request has succeeded.

- ShippingLocationsResponse
  - `data` ShippingLocation[] — Physical locations where orders can be shipped to.
    - `address` Address
      - `city` string — The name of the city.
      - `companyName` string — The name of the company.
      - `country` string — The two-letter country code, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
      - `postalCode` string — The postal code.
      - `stateOrProvince` string — The state or province as defined in [ISO 3166-2](https://www.iso.org/standard/72483.html). For example, **ON** for Ontario, Canada. Applicable for the following countries: - Australia - Brazil - Canada - India - Mexico - New Zealand - United States
      - `streetAddress` string — The name of the street, and the house or building number.
      - `streetAddress2` string — Additional address details, if any.
    - `contact` Contact
      - `email` string — The individual's email address.
      - `firstName` string — The individual's first name.
      - `infix` string — The infix in the individual's name, if any.
      - `lastName` string — The individual's last name.
      - `phoneNumber` string — The individual's phone number, specified as 10-14 digits with an optional `+` prefix.
    - `id` string — The unique identifier of the shipping location, for use as `shippingLocationId` when creating an order.
    - `name` string — The unique name of the shipping location.

## Other responses

- `204` — No Content - the request has been successfully processed, but there is no additional content.
- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/management-api.md) · [All operations](https://skmtc.net/adyen/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/management-api/revisions/1089ade06e17/schema)