# `/reports`

## Endpoints

### `GET` `/v1-dev/reports/<phenotype_name>?population=<population>`

| param types | key            | required | description |
|-------------|----------------|----------|-------------|
| path param  | phenotype_name | TRUE     |             |
| query param | population     | TRUE     | currently only `european` is a valid value. other population is not available now. |

## Response

Property

| params                        | type                             | description                                          |
| ----------------------------- | -------------------------------- | ---------------------------------------------------- |
| **`genome.id`**               | `<integer>`                      | id of the genome                                     |
| **`phenotype.category`**      | `<string>`                       | category of the phenotype                            |
| **`phenotype.name`**          | `<string>`                       | url-safe name of the phenotype (used in URI)         |
| **`phenotype.display_name`**  | `<string>`                       | display name of the phenotype                        |
| **`scores.<index>.score`**    | `<integer>` min: 0, max: 4`      | score of each phenotype interpretation               |
| **`scores.<index>.text`**     | `<string>`                       | description of each phenotype interpretation         |
| **`summary.score`**           | `<integer>` min: 0, max: 4       | summary score of interpreted phenotype of the genome |
| **`summary.text`**            | `<string>`                       | summary description of interpreted phenotype of the genome |

Eg.

```http
GET /v1-dev/reports/eye-color?population=european
```

```http
HTTP 200 OK
Allow: OPTIONS, GET
Content-Type: application/json
Vary: Accept

{
    "genome": {
        "id": 0
    },
    "phenotype": {
        "category": "trait",
        "display_name": "Eye color",
        "name": "eye-color"
    },
    "scores": [
        {
            "score": 0,
            "text": "tend to get blue eyes"
        },
        {
            "score": 1,
            "text": "tend to get blue eyes, slightly"
        },
        {
            "score": 2,
            "text": "normal"
        },
        {
            "score": 3,
            "text": "tend to get blown eyes, slightly"
        },
        {
            "score": 4,
            "text": "tend to get blown eyes"
        }
    ],
    "summary": {
        "score": 2,
        "text": "normal"
    }
}
```