> This page is for version 0.10.
> For other versions, use one of these documentation indexes:
> - Latest (default): https://docs.nvidia.com/nemo-helix/latest/llms.txt
> - 0.10: https://docs.nvidia.com/nemo-helix/v0.10/llms.txt
> - 0.9: https://docs.nvidia.com/nemo-helix/v0.9/llms.txt
> - 0.8: https://docs.nvidia.com/nemo-helix/v0.8/llms.txt
> - 0.7: https://docs.nvidia.com/nemo-helix/v0.7/llms.txt
> - 0.6: https://docs.nvidia.com/nemo-helix/v0.6/llms.txt
> - 0.5: https://docs.nvidia.com/nemo-helix/v0.5/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo-helix/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo-helix/_mcp/server.

# Authenticate Bearer Token Get

GET http://localhost:8080/apis/auth/authenticate

Reference: https://docs.nvidia.com/nemo-helix/documentation/reference/api-reference/authentication/get-authenticate-bearer-token

## Authentication

- `Authorization` header (bearer token, required) — Supply a raw Helix access token. The Authorization header's Bearer prefix is added automatically.

## Response

### 200

Successful Response

- `principal` (string, required)
- `token_kind` (enum, required)
  - Allowed values: `access_key`, `oidc_access_token`, `workload_access_token`, `workload_subject_token`
- `email` (string, optional, nullable)
- `groups` (list of string, optional)
- `scopes` (list of string, optional)
- `jti` (string, optional, nullable)
- `on_behalf_of` (string, optional, nullable)
- `on_behalf_of_email` (string, optional, nullable)
- `on_behalf_of_groups` (list of string, optional)

## Errors

### 401 Unauthorized Error

Missing or invalid bearer token

- `detail` (string, required)

### 500 Internal Server Error

Bearer token authentication is misconfigured

- `detail` (string, required)

## Examples

**Response**

```json
{
  "principal": "string",
  "token_kind": "access_key",
  "email": "string",
  "groups": [
    "string"
  ],
  "scopes": [
    "string"
  ],
  "jti": "string",
  "on_behalf_of": "string",
  "on_behalf_of_email": "string",
  "on_behalf_of_groups": [
    "string"
  ]
}
```

**SDK Code**

```python
import os
import requests

url = "http://localhost:8080/apis/auth/authenticate"
# Set NHX_ACCESS_TOKEN to a raw access token before running.
token = os.environ["NHX_ACCESS_TOKEN"]
headers = {"Authorization": f"Bearer {token}"}

response = requests.request("GET", url, headers=headers)
response.raise_for_status()
print(response.json())

```

```javascript
// Supply `token` from your application's authentication flow before running.
// Do not embed a real token in frontend source or build-time environment variables.
const response = await fetch("http://localhost:8080/apis/auth/authenticate", {
  method: "GET",
  headers: {"Authorization": `Bearer ${token}`},
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

```