> For the complete documentation index, see [llms.txt](https://docs.cryptosat.io/cryptosat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cryptosat.io/cryptosat/api-documentation/randomness-api/tutorial.md).

# Tutorial

## Tutorial

The following is an illustrative example of generating an array of three-digit random numbers.

### Authentication

Make sure you provide an[ API in the header](/cryptosat/api-documentation/authentication.md).

### Get public randomness

Send the following request:

**GET** [`https://api.cryptosat.io/api/randomness?num=3`](https://api.cryptosat.io/api/randomness?num=3)

You should get the following similar response:

```json
{
    "random_numbers": [
        0.548,
        0.361,
        0.74
    ]
}
```

Note that the `num` query parameter corresponds to the desired amount of generated random numbers.