> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telewing247.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Authenticate requests to the Telewing Public API

The Telewing Public API uses **Bearer token** authentication. Every request must include your API key in the `Authorization` header.

## Header format

```http theme={null}
Authorization: Bearer ak_YOUR_API_KEY_HERE
```

## Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.telewing247.com/api/v1/public/user/balance \
    -H "Accept: application/json" \
    -H "Authorization: Bearer ak_YOUR_API_KEY_HERE"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.telewing247.com/api/api/v1/public/user/balance",
    {
      headers: {
        Accept: "application/json",
        Authorization: "Bearer ak_YOUR_API_KEY_HERE",
      },
    }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.telewing247.com/api/v1/public/user/balance",
      headers={
          "Accept": "application/json",
          "Authorization": "Bearer ak_YOUR_API_KEY_HERE",
      },
  )
  data = response.json()
  ```
</CodeGroup>

<Warning>
  Keep your API key secret. Do not commit it to source control or expose it in client-side code.
</Warning>

## Getting an API key

API keys are issued from your Telewing developer dashboard. Each key is prefixed with `ak_`.