# Stores List

Search and paginate the public Morrisons store directory with addresses, coordinates, hours, departments, and services.

- Platform: [Morrisons](https://docs.upscrape.com/docs/platforms/morrisons)
- Capability ID: `morrisons.stores.list`
- Cost: 1 credit per request
- Maximum runtime: 30 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "page": 1,
    "page_size": 5,
    "query": "London"
  },
  "capability": "morrisons.stores.list"
}'
```

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | `integer` | No |  |
| `page_size` | `integer` | No |  |
| `query` | `string` | No | Case-insensitive text search across store name, address, and services. |
| `region` | `string` | No | Case-insensitive exact Morrisons region name. |

### Example input

```json
{
  "page": 1,
  "page_size": 5,
  "query": "London"
}
```

## Response

Successful output is returned in `results[0].data`. Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This redacted fixture is an example, not a fixed response schema.

```json
{
  "page": {
    "has_more": true,
    "page": 1,
    "page_size": 5,
    "returned": 5,
    "total": 102
  },
  "stores": [
    {
      "address": {
        "addressLine1": "King Street",
        "addressLine2": "",
        "city": "London",
        "country": "England",
        "county": "Greater London",
        "postcode": "W3 9NX"
      },
      "convenience": {
        "ExtensionValue": ""
      },
      "departments": [
        {
          "name": "pharmacy",
          "openingTimes": [
            {
              "close": "00:00:00",
              "day": "Monday",
              "day_id": 1,
              "day_short": "mon",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Tuesday",
              "day_id": 2,
              "day_short": "tue",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Wednesday",
              "day_id": 3,
              "day_short": "wed",
              "open": "00:00:00"
            }
          ],
          "serviceName": "Pharmacy"
        },
        {
          "name": "cafe",
          "openingTimes": [
            {
              "close": "17:00:00",
              "day": "Monday",
              "day_id": 1,
              "day_short": "mon",
              "open": "08:00:00"
            },
            {
              "close": "17:00:00",
              "day": "Tuesday",
              "day_id": 2,
              "day_short": "tue",
              "open": "08:00:00"
            },
            {
              "close": "17:00:00",
              "day": "Wednesday",
              "day_id": 3,
              "day_short": "wed",
              "open": "08:00:00"
            }
          ],
          "serviceName": "Cafe"
        },
        {
          "name": "gardenCentre",
          "openingTimes": [
            {
              "close": "00:00:00",
              "day": "Monday",
              "day_id": 1,
              "day_short": "mon",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Tuesday",
              "day_id": 2,
              "day_short": "tue",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Wednesday",
              "day_id": 3,
              "day_short": "wed",
              "open": "00:00:00"
            }
          ],
          "serviceName": "Garden Centre"
        }
      ],
      "linked_locations": [],
      "location": {
        "latitude": 51.508962,
        "longitude": -0.273549
      },
      "name": "Acton",
      "opening_times": [
        {
          "close": "22:00:00",
          "day": "Monday",
          "day_id": 1,
          "day_short": "mon",
          "open": "07:00:00"
        },
        {
          "close": "22:00:00",
          "day": "Tuesday",
          "day_id": 2,
          "day_short": "tue",
          "open": "07:00:00"
        },
        {
          "close": "22:00:00",
          "day": "Wednesday",
          "day_id": 3,
          "day_short": "wed",
          "open": "07:00:00"
        }
      ],
      "pharmacy": {
        "ExtensionValue": ""
      },
      "region": "Greater London",
      "service_highlights": [
        {
          "name": "nutmeg",
          "priority": 17,
          "serviceName": "Nutmeg Clothing"
        },
        {
          "name": "amazonLockers",
          "priority": 18,
          "serviceName": "Amazon Locker"
        },
        {
          "name": "butcher",
          "priority": 25,
          "serviceName": "Butcher"
        }
      ],
      "services": [
        {
          "name": "24HourCash",
          "serviceName": "ATM"
        },
        {
          "name": "amazonLockers",
          "serviceName": "Amazon Locker"
        },
        {
          "name": "amazonReturnsKiosk",
          "serviceName": "Amazon Returns Kiosk"
        }
      ],
      "special_opening_times": [
        {
          "name": "supermarket",
          "specialOpeningTimes": [
            {
              "close": "20:00:00",
              "closed": false,
              "date": "2026-08-31",
              "label": "Monday 31st August (August Bank Holiday)",
              "open": "07:00:00"
            }
          ]
        },
        {
          "name": "cafe",
          "specialOpeningTimes": [
            {
              "close": "17:00:00",
              "closed": false,
              "date": "2026-08-31",
              "label": "Monday 31st August (August Bank Holiday)",
              "open": "08:00:00"
            }
          ]
        },
        {
          "name": "gardenCentre",
          "specialOpeningTimes": [
            {
              "close": "00:00:00",
              "closed": false,
              "date": "2026-08-31",
              "label": "Monday 31st August (August Bank Holiday)",
              "open": "00:00:00"
            }
          ]
        }
      ],
      "store_format": "supermarket",
      "store_type": "Morrisons"
    },
    {
      "address": {
        "addressLine1": "York Place",
        "addressLine2": "London Road",
        "city": "Bath",
        "country": "England",
        "county": "Somerset",
        "postcode": "BA1 6AN"
      },
      "convenience": {
        "ExtensionValue": ""
      },
      "departments": [
        {
          "name": "pharmacy",
          "openingTimes": [
            {
              "close": "00:00:00",
              "day": "Monday",
              "day_id": 1,
              "day_short": "mon",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Tuesday",
              "day_id": 2,
              "day_short": "tue",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Wednesday",
              "day_id": 3,
              "day_short": "wed",
              "open": "00:00:00"
            }
          ],
          "serviceName": "Pharmacy"
        },
        {
          "name": "cafe",
          "openingTimes": [
            {
              "close": "17:00:00",
              "day": "Monday",
              "day_id": 1,
              "day_short": "mon",
              "open": "08:00:00"
            },
            {
              "close": "17:00:00",
              "day": "Tuesday",
              "day_id": 2,
              "day_short": "tue",
              "open": "08:00:00"
            },
            {
              "close": "17:00:00",
              "day": "Wednesday",
              "day_id": 3,
              "day_short": "wed",
              "open": "08:00:00"
            }
          ],
          "serviceName": "Cafe"
        },
        {
          "name": "gardenCentre",
          "openingTimes": [
            {
              "close": "00:00:00",
              "day": "Monday",
              "day_id": 1,
              "day_short": "mon",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Tuesday",
              "day_id": 2,
              "day_short": "tue",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Wednesday",
              "day_id": 3,
              "day_short": "wed",
              "open": "00:00:00"
            }
          ],
          "serviceName": "Garden Centre"
        }
      ],
      "linked_locations": [],
      "location": {
        "latitude": 51.392109,
        "longitude": -2.351593
      },
      "name": "Bath",
      "opening_times": [
        {
          "close": "22:00:00",
          "day": "Monday",
          "day_id": 1,
          "day_short": "mon",
          "open": "07:00:00"
        },
        {
          "close": "22:00:00",
          "day": "Tuesday",
          "day_id": 2,
          "day_short": "tue",
          "open": "07:00:00"
        },
        {
          "close": "22:00:00",
          "day": "Wednesday",
          "day_id": 3,
          "day_short": "wed",
          "open": "07:00:00"
        }
      ],
      "pharmacy": {
        "ExtensionValue": ""
      },
      "region": "South West",
      "service_highlights": [
        {
          "name": "morrisonsNow",
          "priority": 2,
          "serviceName": "Morrisons Now"
        },
        {
          "name": "clickAndCollect",
          "priority": 3,
          "serviceName": "Click & Collect"
        },
        {
          "name": "electricVehicleChargingUltra",
          "priority": 5,
          "serviceName": "Electric Vehicle Charging (Ultra Rapid)"
        }
      ],
      "services": [
        {
          "name": "24HourCash",
          "serviceName": "ATM"
        },
        {
          "name": "amazonLockers",
          "serviceName": "Amazon Locker"
        },
        {
          "name": "amazonReturnsKiosk",
          "serviceName": "Amazon Returns Kiosk"
        }
      ],
      "special_opening_times": [
        {
          "name": "supermarket",
          "specialOpeningTimes": [
            {
              "close": "20:00:00",
              "closed": false,
              "date": "2026-08-31",
              "label": "Monday 31st August (August Bank Holiday)",
              "open": "07:00:00"
            }
          ]
        },
        {
          "name": "cafe",
          "specialOpeningTimes": [
            {
              "close": "17:00:00",
              "closed": false,
              "date": "2026-08-31",
              "label": "Monday 31st August (August Bank Holiday)",
              "open": "08:00:00"
            }
          ]
        },
        {
          "name": "gardenCentre",
          "specialOpeningTimes": [
            {
              "close": "00:00:00",
              "closed": false,
              "date": "2026-08-31",
              "label": "Monday 31st August (August Bank Holiday)",
              "open": "00:00:00"
            }
          ]
        }
      ],
      "store_format": "supermarket",
      "store_type": "Morrisons"
    },
    {
      "address": {
        "addressLine1": "Beacontree Heath",
        "addressLine2": "Wood Lane",
        "city": "Dagenham",
        "country": "England",
        "county": "Essex",
        "postcode": "RM10 7RA"
      },
      "convenience": {
        "ExtensionValue": ""
      },
      "departments": [
        {
          "name": "pharmacy",
          "openingTimes": [
            {
              "close": "00:00:00",
              "day": "Monday",
              "day_id": 1,
              "day_short": "mon",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Tuesday",
              "day_id": 2,
              "day_short": "tue",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Wednesday",
              "day_id": 3,
              "day_short": "wed",
              "open": "00:00:00"
            }
          ],
          "serviceName": "Pharmacy"
        },
        {
          "name": "cafe",
          "openingTimes": [
            {
              "close": "18:00:00",
              "day": "Monday",
              "day_id": 1,
              "day_short": "mon",
              "open": "08:00:00"
            },
            {
              "close": "18:00:00",
              "day": "Tuesday",
              "day_id": 2,
              "day_short": "tue",
              "open": "08:00:00"
            },
            {
              "close": "18:00:00",
              "day": "Wednesday",
              "day_id": 3,
              "day_short": "wed",
              "open": "08:00:00"
            }
          ],
          "serviceName": "Cafe"
        },
        {
          "name": "gardenCentre",
          "openingTimes": [
            {
              "close": "00:00:00",
              "day": "Monday",
              "day_id": 1,
              "day_short": "mon",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Tuesday",
              "day_id": 2,
              "day_short": "tue",
              "open": "00:00:00"
            },
            {
              "close": "00:00:00",
              "day": "Wednesday",
              "day_id": 3,
              "day_short": "wed",
              "open": "00:00:00"
            }
          ],
          "serviceName": "Garden Centre"
        }
      ],
      "linked_locations": [],
      "location": {
        "latitude": 51.560107,
        "longitude": 0.148194
      },
      "name": "Becontree Heath",
      "opening_times": [
        {
          "close": "22:00:00",
          "day": "Monday",
          "day_id": 1,
          "day_short": "mon",
          "open": "07:00:00"
        },
        {
          "close": "22:00:00",
          "day": "Tuesday",
          "day_id": 2,
          "day_short": "tue",
          "open": "07:00:00"
        },
        {
          "close": "22:00:00",
          "day": "Wednesday",
          "day_id": 3,
          "day_short": "wed",
          "open": "07:00:00"
        }
      ],
      "pharmacy": {
        "ExtensionValue": ""
      },
      "region": "Greater London",
      "service_highlights": [
        {
          "name": "morrisonsNow",
          "priority": 2,
          "serviceName": "Morrisons Now"
        },
        {
          "name": "clickAndCollect",
          "priority": 3,
          "serviceName": "Click & Collect"
        },
        {
          "name": "brew",
          "priority": 4,
          "serviceName": "BREW - hot drinks to takeaway"
        }
      ],
      "services": [
        {
          "name": "24HourCash",
          "serviceName": "ATM"
        },
        {
          "name": "amazonLockers",
          "serviceName": "Amazon Locker"
        },
        {
          "name": "amazonReturnsKiosk",
          "serviceName": "Amazon Returns Kiosk"
        }
      ],
      "special_opening_times": [
        {
          "name": "supermarket",
          "specialOpeningTimes": [
            {
              "close": "20:00:00",
              "closed": false,
              "date": "2026-08-31",
              "label": "Monday 31st August (August Bank Holiday)",
              "open": "07:00:00"
            }
          ]
        },
        {
          "name": "cafe",
          "specialOpeningTimes": [
            {
              "close": "00:00:00",
              "closed": false,
              "date": "2026-08-31",
              "label": "Monday 31st August (August Bank Holiday)",
              "open": "00:00:00"
            }
          ]
        },
        {
          "name": "gardenCentre",
          "specialOpeningTimes": [
            {
              "close": "00:00:00",
              "closed": false,
              "date": "2026-08-31",
              "label": "Monday 31st August (August Bank Holiday)",
              "open": "00:00:00"
            }
          ]
        }
      ],
      "store_format": "supermarket",
      "store_type": "Morrisons"
    }
  ]
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `page` | `object` | 5 fields |
| `page.has_more` | `boolean` | true |
| `page.page` | `integer` | 1 |
| `page.page_size` | `integer` | 5 |
| `page.returned` | `integer` | 5 |
| `page.total` | `integer` | 102 |
| `stores` | `array` | 3 items |
| `stores` | `array` | 3 items |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)