# Authentication

> For AI agents: a documentation index is available at [https://heirpros.com/llms.txt](https://heirpros.com/llms.txt). This page is also available as markdown at [https://heirpros.com/developers/authentication.md](https://heirpros.com/developers/authentication.md).

Every HeirPros API request needs an API key. The [MCP server](https://heirpros.com/developers/mcp/) does not.

## Get a key

API keys are issued by HeirPros. [Contact us](https://heirpros.com/contact-us/) to request one. Keep your key private and do not put it in client-side code.

## Send the key

Send your key with every request, in either header:

```
X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY
```

## Base URL

```
https://heirpros.com/api/v1
```

## Check a key

`GET /ping` returns `{ "ok": true }` when the key is valid. Make.com uses this to test a connection.

```bash
curl https://heirpros.com/api/v1/ping -H "X-API-Key: YOUR_API_KEY"
```

```json
{ "ok": true, "api": "HeirPros API", "version": "1.0.0" }
```

A missing or wrong key returns `401` with the code `missing_api_key` or `invalid_api_key`. See [Errors](https://heirpros.com/developers/errors/).
