> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.bloy.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Authentication

The BLOY Public API lets you integrate your app or service with BLOY Loyalty: programmatically access customer data, loyalty points, rewards, ways to earn, VIP tiers, and referrals.
* **Base URL:** https://api.bloy.io
* **Data format:** JSON
* **Authentication:** Bearer token (API Key)
---
## ${color}[#000000](Authentication)

### Get your API Key
1. From the **Navigation Tab**, click on **Settings**.
2. Scroll down to the **Public API** section.
3. Locate your API key and click **Copy** to save it to your clipboard.

|| ⚠️ **Note:** Keep your API key secure. Do not share it publicly or expose it in client-side code.


![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/c/9/59c9b009a3f42400/image-11_hzjp8k.png)
### Using the API Key
Attach the API Key to the `Authorization` header of every request as a Bearer token:
```
curl --request GET \
     --url https://api.bloy.io/rest-api/v1/customers \
     --header 'Authorization: Bearer YourApiKeyGoesHere'
```

If the header is missing, the API Key is invalid, or the shop's plan is not eligible, the API returns:
```
{
  "statusCode": 403,
  "message": "Forbidden"
}
```