> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getscale.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Shipping Regions

Retrieves active shipping regions, shipping rates, popular delivery zones, and flat rates configured by the shop merchant.

Use this endpoint to calculate delivery fees dynamically on checkout screens based on user shipping region choices.

### Authorizations

<ParamField header="X-Shop-API-Key" type="string" required>
  Your Publishable Key (`pk_live_...` or `pk_test_...`) generated from the Developer settings in your dashboard.
</ParamField>

### Path Parameters

<ParamField path="shopId" type="string" required>
  The unique UUID of the shop.
</ParamField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "status": "success",
    "data": [
      {
        "id": 12,
        "regionName": "Lagos Mainland",
        "shippingFeeKobo": 150000,
        "isPopular": true,
        "isOtherCities": false,
        "customRegionName": "Lagos Mainland Delivery"
      }
    ]
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "message": "FORM_VALIDATION_ERROR",
    "code": 400,
    "validationErrors": [
      {
        "path": [
          "shopId"
        ],
        "message": "Invalid UUID format"
      }
    ]
  }
  ```
</ResponseExample>