# Quick Start

## Get your API keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error. You can request API key by filling out a form [here](https://forms.gle/zyi1NopYCtiddSLN9)

## Make your first request

To make your first request, send an authenticated request to the pets endpoint. This will return a list of the latest race results.

## Get list of finished races.

<mark style="color:blue;">`GET`</mark> `https://api.derace.com/api/v1/races/results`

Retrieves a list of all currently open races. Returns 10 results

#### Headers

| Name                                           | Type   | Description      |
| ---------------------------------------------- | ------ | ---------------- |
| x-api-key<mark style="color:red;">\*</mark>    | String | App's API key    |
| content-type<mark style="color:red;">\*</mark> |        | application/json |

#### Request Body

| Name   | Type   | Description                                           |
| ------ | ------ | ----------------------------------------------------- |
| tier   | Number | Tier ID of requested races. **Defaults to 5 (omega)** |
| offset | Number | Number of entries to skip. **Defaults to 0**          |

{% tabs %}
{% tab title="200 Data returned" %}
```javascript
[
    {
        "main_race_id": 129864,
        "start_time": 1669047660000,
        "registration_deadline": 1669047360000,
        "length": 6,
        "v2": true,
        "no_equipment": false,
        "entry_fee": 2000000000000000000,
        "prizes": [
            50,
            30,
            15
        ],
        "tier": "Omega",
        "info": {
            "name": "Omega Race #129864",
            "hippodrome_type": "sakura",
            "hippodrome_name": "Sakura Path",
            "turf": "Turf"
        },
        "places": 12,
        "participants": [
            {
                "number": 821,
                "total": 72646,
                "lane": 1
            },
            {
                "number": 831,
                "total": 73699,
                "lane": 2
            },
            {
                "number": 817,
                "total": 73919,
                "lane": 3
            },
            {
                "number": 839,
                "total": 76073,
                "lane": 4
            },
            {
                "number": 844,
                "total": 74200,
                "lane": 5
            },
            {
                "number": 840,
                "total": 75379,
                "lane": 6
            }
        ],
        "status": "",
        "final_order": [
            0,
            1,
            2,
            4,
            5,
            3
        ],
        "winners": [
            0,
            1,
            2
        ]
    }
]
```
{% endtab %}

{% tab title="401 Permission denied" %}

{% endtab %}
{% endtabs %}

Take a look at how you might call this method using our official libraries, or via `curl`:

{% tabs %}
{% tab title="curl" %}
```
curl https://api.derace.com/api/v1/races/open  
    -H 'x-api-key: API_KEY' 
```
{% endtab %}
{% endtabs %}
