The Pelanor API enables several key use cases:

Internal System Integration

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

Data Enrichment

Enhance Pelanor cloud-cost data with metrics from observability platforms, or import custom cost data.

Reporting & Data Export

Build custom data pipelines to export Pelanor cloud-cost data into external systems for advanced reporting.

Attributes

Many endpoints in the Pelanor API accept filters that reference Attribute IDs. Attributes fall into two main categories:

Properties

Metadata collected by Pelanor from billing data exports, service integrations, and agents. Properties also include Custom Dimensions. Examples include: Region, CloudServiceProvider, Instance Type.

Metrics

Analytics collected from various integrations, including Custom Metrics. These provide measurement and performance insights beyond raw billing data. Examples: CPU Utilization, Average Daily Pods, GPU Hours.
To find the valid ID for a property or metric, use the List Attributes endpoint.
This returns all available attributes along with their display names (as shown in the UI) and short descriptions.

Authentication

All API endpoints require HTTP Bearer authentication. Tokens are managed through the Pelanor platform; you’ll need to log in with an Administrator account to create a new token.
1

Log in to Pelanor

Log in to your Pelanor environment with an admin-level account.
2

Open the API Tokens page

Go to Settings → API Tokens.
3

Generate a new token

Give the token a descriptive name (e.g., integration or project).
Select the least-privilege role that still covers the endpoints you need.
For details, see the Roles & Permissions reference.
4

Store the token securely

After clicking Generate Token, you will receive a Token ID and Token Secret.
Copy them immediately and store them securely—the secret is shown only once.
5

Add the Authorization header

Sign every request with the following header:Authorization: Bearer <Token ID>:<Token Secret>

Basic Request Example

export PELANOR_API_TOKEN="aa11bb22cc33dd44:ee55ff66gg77hh88"

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