---
source_url: https://www.pubnub.com/docs/pubnub-insights/api
title: Insights REST API
updated_at: 2026-06-04T11:10:44.018Z
---

> Documentation Index
> For a curated overview of PubNub documentation, see: https://www.pubnub.com/docs/llms.txt
> For the full list of all documentation pages, see: https://www.pubnub.com/docs/llms-full.txt


# Insights REST API

Besides accessing Insights metrics through [Admin Portal](https://admin.pubnub.com/), Insights Premium users can access their metrics using API.

To read about the available metrics, categories, and their limitations, refer to the general [Insights API documentation](https://www.pubnub.com/docs/admin-api/insights-introduction).

## Authentication

The Insights API uses API key authentication. Include your API key in the `Authorization` header of every request:

```text
curl --header 'PubNub-Version: YYYY-MM-DD' --header 'Authorization: YOUR_API_KEY_HERE' ...
```

For instructions on how to generate and manage your API key, refer to the [Admin API authentication documentation](https://www.pubnub.com/docs/admin-api#authentication-and-authorization).

...