Get a list of shipping locations

https://management-test.adyen.com/v1/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: * Management API—Terminal ordering read * Management API—Terminal ordering read and write

Access Token Required: API Key

Path Parameters

merchantIdstringrequired

The unique identifier of the merchant account.

Query Params

namestring

The name of the shipping location.

offsetinteger

The number of locations to skip.

limitinteger

The number of locations to return.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://management-test.adyen.com/v1/merchants/{merchantId}/shippingLocations' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET