# Public API

### [Overview](#webhooks) <a href="#webhooks" id="webhooks"></a>

This reference documents the public API that can be used to get information about Waitlists and product availability, both server- and client-side.

### [Authentication](#authentication) <a href="#authentication" id="authentication"></a>

Include your store's public API key as an `api_key` query parameter in all requests.

### [Versioning](#versioning) <a href="#versioning" id="versioning"></a>

The API is versioned using a URL prefix. The current version is `v1`, and all endpoints use the `/api/v1/` namespace.

### [Response Format](#response-format) <a href="#response-format" id="response-format"></a>

All responses follow a common format:

{% code overflow="wrap" %}

```json
{
  "meta": {
    "result": "success"
  },
  "data": /* Response data */
}
```

{% endcode %}

### [Endpoints](#endpoints) <a href="#endpoints" id="endpoints"></a>

[waitlists](https://docs.getpurpledot.com/docs/purple-dot-apis/public-api/waitlists "mention")

[availability](https://docs.getpurpledot.com/docs/purple-dot-apis/public-api/availability "mention")

[products-preorder-state](https://docs.getpurpledot.com/docs/purple-dot-apis/public-api/products-preorder-state "mention")

[variants-preorder-state](https://docs.getpurpledot.com/docs/purple-dot-apis/public-api/variants-preorder-state "mention")

[pre-orders](https://docs.getpurpledot.com/docs/purple-dot-apis/public-api/pre-orders "mention")