The Pelanor API is useful for the following use cases:

Internal System Integration

Connect CRM, ERP, and other enterprise software to sync Pelanor dimensions and segments with your business‑contextual data.

Data Enrichment

Augment Pelanor cloud‑cost data with metrics from your observability platforms, and import custom cost data.

Reporting & Data Export

Build custom data pipelines to export Pelanor cloud‑cost data to external systems.

​
Authentication

All API endpoints use HTTP Bearer authentication.

1

Log in to Pelanor

Log in to your Pelanor environment with an admin‑level user.

2

Open the API Tokens page

Navigate to Settings → API Tokens.

3

Generate a new token

Give the token a descriptive name (e.g., the integration or project name).
Select the least‑privilege role that still covers the endpoints you plan to call.
For guidance, see the Roles & Permissions reference.

4

Store the token securely

After you click Generate Token, you will see Token ID and Token Secret values.
Copy them once and store them in a secure location—​the secret is shown only once.

5

Add the Authorization header

Sign every request with the header:

Authorization: Bearer <Token ID>:<Token Secret>

​
Example

export PELANOR_API_TOKEN="aa11bb22cc33dd44:ee55ff66gg77hh88"

curl -X GET https://api.pelanor.io/v1/dimensions \
  -H "Authorization: Bearer $PELANOR_API_TOKEN" \
  -H "Content-Type: application/json"