# A group call

`GET https://rest.wordplus.cloud/wordplus/realtime/calls/{name}`

The people in a group call and what each sends now: camera, microphone and screen, each true while it is on and not
muted. A call with nobody in it, never or no longer, answers `people` 0, `started_at` null and an empty `list`.

In the packages: `realtime.call( name ).get()`.

## Parameters

| Name | In | |
|---|---|---|
| `name` (required) | path | The group call name, percent-encoded: `meeting:7` is `meeting%3A7`. |

## Answer

The call.

```json
{
  "ok": true,
  "call": {
    "name": "meeting:7",
    "people": 2,
    "started_at": 1791638400000,
    "list": [
      {
        "user": "42",
        "joined_at": 1791638400000,
        "camera": true,
        "microphone": true,
        "screen": false
      },
      {
        "user": "43",
        "joined_at": 1791638410000,
        "camera": false,
        "microphone": true,
        "screen": false
      }
    ]
  }
}
```

## Refusals

- **400**: `bad_request`, `bad_room`: the request is not one the API takes. `reserved`: an event name kept for the room itself.
- **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/meeting%3A7'
```

**Node**

```js
const { call } = await wordplus('GET', `/wordplus/realtime/calls/${encodeURIComponent('meeting:7')}`);
```

**Python**

```python
call = wordplus("GET", f"/wordplus/realtime/calls/{quote('meeting:7', safe='')}")["call"]
```

**PHP**

```php
$call = wordplus('GET', '/wordplus/realtime/calls/'.rawurlencode('meeting:7'))['call'];
```

**Go**

```go
answer, err := app.Request("GET", "/wordplus/realtime/calls/"+url.PathEscape("meeting:7"), nil)
```