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

# Authentication

> How to authenticate your API requests with Unipay

# Authentication

All API requests require authentication using API keys passed in the Authorization header.

## Using API Keys

Include your API key in the Authorization header:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.unipay.com/v1/quote
```

## API Key Permissions

| Permission | Description                          |
| ---------- | ------------------------------------ |
| **read**   | View quotes and transaction status   |
| **write**  | Create transactions and webhooks     |
| **admin**  | Full access including key management |

## Rate Limits

| Tier           | Requests/Minute | Monthly Quota |
| -------------- | --------------- | ------------- |
| **Free**       | 60              | 10,000        |
| **Pro**        | 300             | 100,000       |
| **Enterprise** | 1,000           | 1,000,000     |

Rate limit headers:

```http theme={null}
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1640995200
```

## Security Best Practices

* Never commit API keys to version control
* Rotate keys regularly
* Use environment variables
* Implement key rotation strategy
* Monitor API usage for anomalies