Operators

The owners and operators of malls: portfolios and tenant mix.

GET/operatorsLevel 1

List operators

Mall owners and operators with a published portfolio.

Parameter	In	Type	Description
`q`	query	string	Search by name.
`country`	query	string	ISO 3166-1 alpha-2 country code. Repeat or comma-separate for several.
`limit`	query	integer	Items per page, 1 to 100 (default 25).
`cursor`	query	string	The `next_cursor` of the previous page.

Request

curl "https://api.retailbrands.global/v1/operators?q=zara&country=GB" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · OperatorList

{
  "data": [
    {
      "id": "landsec",
      "slug": "landsec",
      "name": "Landsec",
      "website": "landsec.com",
      "malls": 31,
      "brands": {
        "total": 667,
        "monitored": 101
      },
      "stores": 140,
      "countries": [
        "GB"
      ]
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Object fields: Data model · Operator

GET/operators/{id}Level 1

Get an operator

One operator with its profile and portfolio totals.

Parameter	In	Type	Description
`id`	path	string · required	Identifier of the operator, as returned in `id`.

Request

curl "https://api.retailbrands.global/v1/operators/landsec" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · Operator

{
  "id": "landsec",
  "slug": "landsec",
  "name": "Landsec",
  "website": "landsec.com",
  "malls": 31,
  "brands": {
    "total": 667,
    "monitored": 101
  },
  "stores": 140,
  "countries": [
    "GB"
  ],
  "description": null,
  "gla_m2": null,
  "categories": [
    "Fashion",
    "Food & Beverage"
  ]
}

Object fields: Data model · Operator

GET/operators/{id}/mallsLevel 1

Malls of an operator

The operator's portfolio of malls.

Parameter	In	Type	Description
`id`	path	string · required	Identifier of the operator, as returned in `id`.
`limit`	query	integer	Items per page, 1 to 100 (default 25).
`cursor`	query	string	The `next_cursor` of the previous page.

Request

curl "https://api.retailbrands.global/v1/operators/landsec/malls?limit=25" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · MallList

{
  "data": [
    {
      "id": "liverpool-one",
      "name": "Liverpool ONE",
      "country": "GB",
      "brands": {
        "monitored": 39
      },
      "stores": 41
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Object fields: Data model · Mall

Objects

Operator

An owner or operator of malls.

Field	Type	Description
`id`	string	The operator slug, stable and URL-safe.
`slug`	string	Same as id.
`name`	string
`website`	string \| null
`malls`	integer	Malls in the published portfolio.
`brands`	object	total brands trading in its malls, monitored among them.
`stores`	integer	Stores of monitored brands.
`countries`	array	ISO country codes of its malls.

Mall

A shopping centre.

Field	Type	Description
`id`	string	The mall slug, stable and URL-safe.
`name`	string
`country`	string \| null	ISO alpha-2.
`region`	string \| null
`type`	string \| null	Shopping mall, Outlet mall or Retail park.
`gla_m2`	number \| null	Gross leasable area in square metres.
`operators`	array	Owners and operators: id, name.
`brands`	object	monitored: number of monitored brands trading there.
`stores`	integer	Stores of monitored brands.

← Malls Stores →