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

# Authentication

> How to authenticate requests to the Fiet Trading API.

## Authentication method

The Fiet Trading API uses **HTTP Basic Authentication** (MVP). Credentials are issued per organisation and environment.

Include an `Authorization` header on every request:

* `Authorization: Basic <base64(username:password)>`

## Environments

| Environment          | Base URL                   |
| -------------------- | -------------------------- |
| Production (example) | `https://api.fiet.finance` |
| Sandbox              | Coming soon                |

## Example request

```bash theme={null}
curl -sS \
  -H "Authorization: Basic <base64(username:password)>" \
  "https://api.fiet.finance/health"
```

## Error responses

Common responses you should handle:

* **401 Unauthorized**: missing or invalid credentials
* **403 Forbidden**: credentials are valid, but access is not permitted
* **400 Bad Request**: invalid parameters or request body (see `Problem` schema)

Where applicable, error responses follow an RFC 7807-style shape:

```json theme={null}
{
  "type": "string",
  "title": "string",
  "status": 400,
  "detail": "string"
}
```
