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

# Server to server

> Here reside all endpoints available for Server2Server services.

## Store Verification

Store verification endpoint serves for validating the store where a device is present using EDDYSTONE Ephemeral Identifiers (EID) read from the installed BLE beacons. EID identifiers need to be provided (`readings` field) and the store (`store` field) will be returned if verification succeeds, else an error will be returned instead.

### Resource \[POST]

`[/stores/verify/]`

### Request

```
{
  "readings": ["7ce21f44c8a30614","bc908667616da718","7ce21f44c8a30614"]
}
```

### Response

```
{
  "store": "AHQ21000"
}
```

### Errors

Bespot API uses HTTP status code `400` to communicate errors. A `code`, `detail` JSON structure is used. See below.

#### Multiple stores

```
{
  "error_code": "multiple_stores_for_eids",
  "detail": "Multiple stores found (X) for given readings/EIDs."
}
```

#### No stores

```
{
  "error_code": "no_stores_found",
  "detail": "No store found matching the provided identifiers."
}
```

### Example cURL

```
curl --location --request POST 'https://blueprint.bespot.io/api/stores/verify/' \
--header 'Authorization: Basic afGeTREhfR72AkOlZqLGn4wBXvzVsHJyUI==' \
--header 'Content-Type: application/json' \
--data-raw '{
  "readings": ["bfc0d982cf74aa4c","effab4e23b0b5cdc","adcb8179af7aeb9c"]
}'
```