# The group calls going on

`GET https://rest.wordplus.cloud/wordplus/realtime/calls`

The group calls of your app with someone in them now, by name, with how many are in each and since when. A call
between two people that became a group call is `call:` and its id. Calls between two people run between their
browsers, so they are not here.

In the packages: `realtime.listCalls()`.

## Answer

The calls.

```json
{
  "ok": true,
  "calls": [
    {
      "name": "meeting:7",
      "people": 4,
      "started_at": 1791638400000
    }
  ]
}
```

## Refusals

- **401**: `missing_signature`, `stale_signature` (a clock off by more than 5 minutes), `unknown_site`, `bad_signature` (a wrong secret, or a body or path other than the one signed).
- **403**: `not_included`: your plan does not include it.

## Examples

`wordplus()` (in Go `app.Request()`) signs and sends the request: https://docs.wordplus.cloud/api/signing/ has it in each language.

**curl**

```bash
wordplus GET '/wordplus/realtime/calls'
```

**Node**

```js
const { calls } = await wordplus('GET', '/wordplus/realtime/calls');
```

**Python**

```python
calls = wordplus("GET", "/wordplus/realtime/calls")["calls"]
```

**PHP**

```php
$calls = wordplus('GET', '/wordplus/realtime/calls')['calls'];
```

**Go**

```go
answer, err := app.Request("GET", "/wordplus/realtime/calls", nil)
```