API ReferenceEndpointsPublic API (v1)List the store regions

List the store regions

Lists the store regions, the default region first, then by name.

GET
/v1/regions
AuthorizationBearer <token>

Admin API key (server-to-server). Issue via the dashboard at Settings → API keys. Plain-text key is shown once — store in a secret manager. Format: Authorization: Bearer brainerce_xxxxxxxxx.

In: header

Query Parameters

page?integer

1-based page number.

Default1
Range1 <= value
limit?integer

Items per page. Default 20. Maximum 100.

Default20
Range1 <= value <= 100
curl -X GET "https://api.brainerce.com/api/v1/regions?page=1&limit=20"
{
  "data": [
    {
      "id": "clx1a2b3c4d5e6f7g8h9",
      "accountId": "clx1a2b3c4d5e6f7g8h9",
      "storeId": "clx1a2b3c4d5e6f7g8h9",
      "name": "Israel",
      "slug": "israel",
      "currency": "USD",
      "fxBufferPercent": "2.00",
      "countries": [
        "string"
      ],
      "provinces": {},
      "taxInclusive": true,
      "effectiveTaxInclusive": true,
      "automaticTaxes": true,
      "isDefault": true,
      "isActive": true,
      "metadata": {},
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "paymentProviders": [
        {
          "id": "clx1a2b3c4d5e6f7g8h9",
          "regionId": "clx1a2b3c4d5e6f7g8h9",
          "appInstallationId": "clx1a2b3c4d5e6f7g8h9",
          "isEnabled": true,
          "createdAt": "2019-08-24T14:15:22Z"
        }
      ]
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 137,
    "totalPages": 7
  }
}

{
  "statusCode": 401,
  "code": "UNAUTHORIZED",
  "message": "Invalid or expired credential",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/v1/products/bulk/{jobId}"
}

{
  "statusCode": 403,
  "code": "INSUFFICIENT_SCOPE",
  "message": "API key does not have the required scope: products:write",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/v1/regions"
}

{
  "statusCode": 429,
  "code": "RATE_LIMITED",
  "message": "Too many requests",
  "details": {
    "retryAfterSeconds": 12
  },
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/v1/store"
}