# Global Statistics API

### Intro

The Global Statistics API provides network-wide usage metrics across Karrier One’s public infrastructure, including gateways, WiFi nodes, and client sessions. These endpoints allow you to retrieve live and historical data usage trends, unique client counts, and session statistics.

### How It Works

All endpoints return `200 OK` responses with usage data in JSON format. The statistics are grouped by:

* **Global Public Stats**: High-level aggregate of total users, GBs, and sessions.
* **Gateway Stats**: Time-based usage from public gateways.
* **WiFi Stats**: Time-based usage from WiFi infrastructure.
* **WiFi Nodes**: Detailed node-level information.
* **KNS Stats**: Karrier Number System Users and time-based signups per country

Some endpoints require a date range in ISO 8601 format for historical analysis.

{% openapi src="<https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2Fwpk5p4v0wEOlCskbwLRG%2Fn-api-swagger-public.json?alt=media&token=3183672e-08c1-423d-a332-4f9213c5c03e>" path="/api/v1/UsageGraph/global-public-stats" method="get" %}
[n-api-swagger-public.json](https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2Fwpk5p4v0wEOlCskbwLRG%2Fn-api-swagger-public.json?alt=media\&token=3183672e-08c1-423d-a332-4f9213c5c03e)
{% endopenapi %}

{% openapi src="<https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2Fwpk5p4v0wEOlCskbwLRG%2Fn-api-swagger-public.json?alt=media&token=3183672e-08c1-423d-a332-4f9213c5c03e>" path="/api/v1/UsageGraph/global-public-gateway-stats" method="post" %}
[n-api-swagger-public.json](https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2Fwpk5p4v0wEOlCskbwLRG%2Fn-api-swagger-public.json?alt=media\&token=3183672e-08c1-423d-a332-4f9213c5c03e)
{% endopenapi %}

{% openapi src="<https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2Fwpk5p4v0wEOlCskbwLRG%2Fn-api-swagger-public.json?alt=media&token=3183672e-08c1-423d-a332-4f9213c5c03e>" path="/api/v1/UsageGraph/global-public-wifi-stats" method="post" %}
[n-api-swagger-public.json](https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2Fwpk5p4v0wEOlCskbwLRG%2Fn-api-swagger-public.json?alt=media\&token=3183672e-08c1-423d-a332-4f9213c5c03e)
{% endopenapi %}

{% openapi src="<https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2Fwpk5p4v0wEOlCskbwLRG%2Fn-api-swagger-public.json?alt=media&token=3183672e-08c1-423d-a332-4f9213c5c03e>" path="/api/v1/Wifi/wifi-nodes" method="post" %}
[n-api-swagger-public.json](https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2Fwpk5p4v0wEOlCskbwLRG%2Fn-api-swagger-public.json?alt=media\&token=3183672e-08c1-423d-a332-4f9213c5c03e)
{% endopenapi %}

{% openapi src="<https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2Fwpk5p4v0wEOlCskbwLRG%2Fn-api-swagger-public.json?alt=media&token=3183672e-08c1-423d-a332-4f9213c5c03e>" path="/api/v1/UsageGraph/global-public-kns-stats" method="post" %}
[n-api-swagger-public.json](https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2Fwpk5p4v0wEOlCskbwLRG%2Fn-api-swagger-public.json?alt=media\&token=3183672e-08c1-423d-a332-4f9213c5c03e)
{% endopenapi %}

### Conclusion

The Global Statistics API is what you need to embed Karrier One's global analytics into your project.

If you have questions or need assistance, please reach out to <support@karrier.one>.

### 🔗 Reference

{% file src="<https://1343437234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2J36Me8m3Rq5gwWD8Fvi%2Fuploads%2Fwpk5p4v0wEOlCskbwLRG%2Fn-api-swagger-public.json?alt=media&token=3183672e-08c1-423d-a332-4f9213c5c03e>" %}
Karrier One Global Statistics OpenAPI
{% endfile %}