# Check the key and read the connection's state

`GET https://management.horeca-24.de/api/partner/v1/ping`

`menuUrl`, `menuHash` and `menuUpdatedAt` are `null` until the restaurant first syncs its menu. `menuHash` is
the SHA-256 (hex) of the menu file's current bytes.

## Headers

- `Authorization` (string, required): Bearer $PARTNER_API_KEY

## Response

### 200 — The connection

- `connectionId` (string, required, pattern: `^pc_[0-9a-f]{20}$`)
- `name` (string, required)
  The connection's name; orders appear in the till under it
- `storeName` (string or null, required)
  The restaurant's name
- `storeStatus` (string, required, `online` | `offline`)
  `online` while the restaurant takes orders through this connection
- `webhookConfigured` (boolean, required)
- `menuUrl` (string or null, required, format: uri)
  The menu file; null before the first menu sync
- `menuHash` (string or null, required, pattern: `^[0-9a-f]{64}$`)
  SHA-256 (hex) of the file's bytes
- `menuUpdatedAt` (string or null, required, format: date-time)
  The last write of the file

## Errors

- `401`: `UNAUTHORIZED`: the key is missing, malformed, unknown, wrong, expired or revoked
- `403`: `CONNECTION_REVOKED`: the restaurant deleted the connection; stop sending

## Code example (cURL)

```sh
curl https://management.horeca-24.de/api/partner/v1/ping \
  -H "Authorization: Bearer $PARTNER_API_KEY"
```

## Response 200 — Example

```json
{
  "connectionId": "pc_3f1c0a9e5b7d2c4f6a81",
  "name": "Test-Partner A",
  "storeName": "Pizzeria Roma",
  "storeStatus": "online",
  "webhookConfigured": true,
  "menuUrl": "https://cdn.horeca-24.de/partner-api/menus/pc_3f1c0a9e5b7d2c4f6a81/menu.json",
  "menuHash": "9b2f6a1c0d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f90",
  "menuUpdatedAt": "2026-10-15T09:58:12.000Z"
}
```