---
title: "Ping"
operation_id: "api.partner.wolt.ping"
method: GET
path: "/api/partner/v1/wolt/ping"
group: "Wolt Partner API"
authenticated: true
canonical: "https://fature.al/api-reference/endpoints/api-partner-wolt-ping.html"
---

# Ping

Part of the [fature.al API](/api-reference/index.html) documentation.

## GET /api/partner/v1/wolt/ping

Verify the token and return the single Wolt venue it is bound to. Call this
first to confirm credentials and discover which company/branch/venue the
token operates on.

Full URL: `https://fature.al/api/partner/v1/wolt/ping`

Authentication: required (bearer token).

### Example request

```bash
curl -X GET 'https://fature.al/api/partner/v1/wolt/ping' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json'
```

### Responses

**200** — OK

| Field | Type | Description |
| --- | --- | --- |
| `status` | boolean |  |
| `data` | object |  |
| `data.company` | string |  |
| `data.branch` | string |  |
| `data.venue_id` | string |  |
| `data.connection_status` | string |  |
| `data.server_time` | string |  |

```json
{
    "status": true,
    "data": {
        "company": "company",
        "branch": "branch",
        "venue_id": "venue id",
        "connection_status": "connection status",
        "server_time": "server time"
    }
}
```

**403** — The company has no Wolt add-on, the token has no Wolt right, or it resolves to no single active venue.

| Field | Type | Description |
| --- | --- | --- |
| `status` | boolean | Always false |
| `message` | string | Localised explanation, safe to log but not to branch on |
| `code` | string | Stable machine readable reason: `unauthenticated`, `wolt_not_enabled`, `forbidden`, `no_venue`, `order_not_found`, `invalid_transition`, `invalid_data`, `action_failed`, `wolt_upstream_error`, `idempotency_key_required`, `idempotency_in_progress` |

```json
{
    "status": true,
    "message": "Hello there",
    "code": "code"
}
```

**429** — Rate limit reached: 180 reads a minute per token. Retry after the number of seconds in the Retry-After header.

| Field | Type | Description |
| --- | --- | --- |
| `message` | string |  |

```json
{
    "message": "Hello there"
}
```