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

# Authentication

> Authenticate Finup API requests with API keys.

Finup API integrations authenticate with API keys.

Send your API key in the `x-api-key` header on every request.

## API key request

```bash theme={null}
curl --request GET "https://api.finup.dev/account" \
  --header "x-api-key: $FINUP_API_KEY"
```

<Warning>
  Keep API keys server-side. Do not put them in browsers, mobile apps, logs, analytics events, or customer-visible error messages.
</Warning>

## Response envelope

Successful responses are usually wrapped in `result`.

```json theme={null}
{
  "result": {
    "status": true
  }
}
```

Authentication failures return `401`.

```json theme={null}
{
  "status_code": 401,
  "error_message": "Unauthorized"
}
```