---
updatedAt: 2025-05-08T22:17:39.000Z
agentTools:
  projectIndex: https://docs.koalafi.com/llms.txt
---

# Authentication

## API Keys

Koalafi has both protected apis and unprotected apis.  For unprotected apis we authorize your request based on a `Public Dealer ID` and for protected we use a `Private API key` that are passed up via a header in the request.  Using these values will allow you to securely access our apis.

### How to Obtain

During dealer onboarding you will be issued a public dealer id and a private api key.  In order to call our unprotected apis you will need to provide this value in a `public-dealer-id` header for each request.

```json
{
  "public-dealer-id":"<public dealer id value>"
}
```

For our protected APIs you will need to add a `private-api-key` header to the protected request.

```json
{
  "public-dealer-id":"<public dealer id value>",
  "private-api-key":"<private api key value>",
}
```