# \[LEGACY] Public API Reference

### NOTE: With the release of Public API v2, Public API v1 will be sunset in May of 2024!

Find the v2 reference [here](https://help.inveterate.com/dev/api-reference-docs/public-api-2.0-reference).

## Authentication

{% hint style="warning" %}
API Keys are private and should not be shared or exposed on the front end.
{% endhint %}

### Using API Key in Requests

Include your API key as an `X-Inveterate-Api-Key` header on all API endpoint requests.

## Requirements

All API requests utilize `https://public.inveterateapi.com/` as the base URL.

### Example Get Request

{% tabs %}
{% tab title="Curl" %}

```shell
curl -X GET "https://public.inveterateapi.com/merchant"
-H "X-Inveterate-Api-Key: {api_key}"
```

{% endtab %}

{% tab title="Node Fetch" %}

```javascript
const merchant = await fetch('https://public.inveterateapi.com/merchant', {
  headers: {
    'Content-Type': 'application/json',
    'X-Inveterate-Api-Key': '{api_key}',
  },
  method: 'GET',
}).then(data => data.json());
```

{% endtab %}
{% endtabs %}

## Reference Shortcuts

{% content-ref url="legacy-public-api-reference/benefits-api" %}
[benefits-api](https://help.inveterate.com/dev/api-reference-docs/legacy-public-api-reference/benefits-api)
{% endcontent-ref %}

{% content-ref url="legacy-public-api-reference/campaigns-api" %}
[campaigns-api](https://help.inveterate.com/dev/api-reference-docs/legacy-public-api-reference/campaigns-api)
{% endcontent-ref %}

{% content-ref url="legacy-public-api-reference/customers-api" %}
[customers-api](https://help.inveterate.com/dev/api-reference-docs/legacy-public-api-reference/customers-api)
{% endcontent-ref %}

{% content-ref url="legacy-public-api-reference/merchant-api" %}
[merchant-api](https://help.inveterate.com/dev/api-reference-docs/legacy-public-api-reference/merchant-api)
{% endcontent-ref %}

{% content-ref url="legacy-public-api-reference/webhooks" %}
[webhooks](https://help.inveterate.com/dev/api-reference-docs/legacy-public-api-reference/webhooks)
{% endcontent-ref %}

{% content-ref url="legacy-public-api-reference/free-tiers-api" %}
[free-tiers-api](https://help.inveterate.com/dev/api-reference-docs/legacy-public-api-reference/free-tiers-api)
{% endcontent-ref %}