# List your AIs

`GET https://api.cryptohopper.com/v1/ai`

Part of [AI](https://www.cryptohopper.com/api-documentation/api-reference/ai.md) in the Cryptohopper API reference.

Returns the AIs (Algorithm Intelligence setups) on your account, ordered by name.

The handler checks no OAuth scope: any valid access token can call it.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/ai" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": [
        {
            "id": "87001",
            "name": "My BTC AI",
            "description": "Trend and signal strategies for BTC markets",
            "logo": "https://cdn.example.com/images/ai/ai_87001.png",
            "created_date": "2026-05-01 10:00:00"
        }
    ]
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.