# API reference

### Authentication

This API relies on provisioned API keys for authentication and access. In order to obtain a key, please contact us.

[Read more](https://docs.cryptosat.io/cryptosat/api-documentation/authentication)

### Public randomness

Invoke the following API to receive public randomness

## Get public randomness

<mark style="color:blue;">`GET`</mark> `https://api.cryptosat.io/api/randomness?num=`

#### Query Parameters

| Name | Type   | Description                          |
| ---- | ------ | ------------------------------------ |
| num  | String | amount of random numbers to generate |

#### Headers

| Name                                        | Type   | Description      |
| ------------------------------------------- | ------ | ---------------- |
| x-api-key<mark style="color:red;">\*</mark> | String | Required API Key |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
  "request": {
    "request_uuid": "string",
    "request_name": "string",
    "request_verb": "string",
    "response_eta": "string",
    "created_at": "string",
    "satellite_id": "string",
    "request_status": {
      "status_code": "string",
      "request_status": "string"
    }
  }
}
```

{% endtab %}

{% tab title="403: Forbidden Please check your API key" %}

{% endtab %}
{% endtabs %}