API access

Query nxbase programmatically with a personal token you create on your account page. A token acts with your access: admins see everything hosted, members see the public projection.

Base URL

https://enextgen.it/nxbase-api

Authentication

Send your token as a Bearer header:

Authorization: Bearer nxb_your_token_here

Endpoint

• GET /data — JSON rows (paginated)
• GET /data.csv — all matching rows as CSV
• GET /health — liveness (no auth)

Filters (multi-value): parameter, source, commodity, activity, flow, site, period, unit… plus sort, dir, page, limit.

Examples

curl:

curl -H "Authorization: Bearer nxb_xxx" \
  "https://enextgen.it/nxbase-api/data.csv?parameter=Import%20mix&period=2024"

Python (pandas):

import io, requests, pandas as pd

r = requests.get(
    "https://enextgen.it/nxbase-api/data.csv",
    params={"parameter": "Total output", "source": "EMBER generation 2025"},
    headers={"Authorization": "Bearer nxb_xxx"},
)
df = pd.read_csv(io.StringIO(r.text))

Managing tokens

Create, list and revoke tokens on your account page. The full token is shown once, at creation — store it then. A revoked token stops working immediately.