> For the complete documentation index, see [llms.txt](https://docs.giftpro.co.uk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giftpro.co.uk/reference/locations.md).

# Locations

The location object represent a real world venue, a single property may have many locations up and down the country for example. Redemptions, topups and new orders can all be assigned a locationID to identify where they occured on a granular level.

All API keys have access to this endpoint.

## List locations

<mark style="color:blue;">`GET`</mark> `https://api.giftpro.co.uk/locations/`

The locations can be filtered to those assigned to a specific property using `domainID` as a filter parameter

#### Query Parameters

| Name     | Type | Description                                            |
| -------- | ---- | ------------------------------------------------------ |
| domainID | int  | Show only locations assigned to the specified property |

{% tabs %}
{% tab title="200: OK " %}

```json
[
  {
      "locationID": 71,
      "name": "Lymington Hotel Montagne",
      "addressLine1": "Stirley House",
      "addressLine2": "Stirley Park",
      "locality": "Lymington",
      "county": "Hampshire",
      "country": "United Kingdom",
      "address": "GBP"
  },
  {...}
]
```

{% endtab %}
{% endtabs %}