# athletes

## Retrieving Athletes

## Retrieve athlete(s).

<mark style="color:blue;">`GET`</mark> `https://487q8d7goe.execute-api.us-east-1.amazonaws.com/production/athletes`

Obtains all the athletes or a specific athlete within your Valor account.

#### Query Parameters

| Name      | Type   | Description                               |
| --------- | ------ | ----------------------------------------- |
| athleteID | String | ID of specific athlete for focused search |

#### Headers

| Name                                            | Type   | Description                                                                          |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------ |
| Authorization<mark style="color:red;">\*</mark> | String | <p>JWT Bearer Token for authentication: <br><strong>Bearer \<JWT token></strong></p> |

{% tabs %}
{% tab title="200: OK Athletes successfully retrieved" %}

```json
{
    "statusCode": 200,
    "body": [{"ValorID": id, "FirstName": first_name, "LastName": last_name},
             {"ValorID": id2, "FirstName": first_name2, "LastName": last_name2},
        ...] //Array of athletes found
}
```

{% endtab %}

{% tab title="404: Not Found No athletes found for the organization" %}

```json
{
    "message": "String type - this will contain more details about the problem encountered"
}
```

{% endtab %}

{% tab title="500: Internal Server Error Endpoint request timed out" %}

```json
{
    "message": "String type - this will contain more details about the problem encountered"
}
```

{% endtab %}
{% endtabs %}