The ekko Climate API includes fees in every contribution and credit purchase. You don’t need to calculate fees yourself. The API returns final amounts with all fees included and breaks them out as separate fields so you can see exactly how the total is composed.

Service fee

The service fee is included in every contribution and credit. It’s typically set at 20% of the impact amount, though the exact percentage is configured by ekko during onboarding.

The API returns the service fee as its own field in responses, so you can always see the split between the impact amount and the service fee.

{
  "totalAmount": 12.6,
  "impactAmount": 10.0,
  "serviceFeeAmount": 2.0,
  "serviceFeeSalesTaxAmount": 0.4
}

totalAmount is the sum of all components: the impact amount, service fee and applicable sales tax.

Profit share

The service fee is shared between ekko and the organisations in the hierarchy. This creates a revenue stream for commercial partners and their child organisations while directing the majority of funds to verified environmental projects.

Each organisation has two profit share values:

Relative profit share

The relativeProfitShare is the percentage of the service fee that an organisation receives from its direct parent. You set this when creating an organisation. It’s expressed as a decimal: a value of 0.6 means the organisation receives 60% of the service fee passed down from its parent.

{
  "relativeProfitShare": 0.6
}

Proportional profit share

The proportionalProfitShare is the organisation’s effective share of the total service fee after the full hierarchy is applied. The API calculates this automatically based on the relative profit shares of all organisations in the chain.

For example, if the service fee is 20% and an organisation’s proportional profit share is 0.12, that organisation receives 12% of the total service fee on each transaction.

{
  "relativeProfitShare": 0.6,
  "proportionalProfitShare": 0.12,
  "serviceFeePercentage": 0.2
}

You set the relativeProfitShare when you create or update an organisation. If you don’t provide a value, it defaults to 0. See the Create organisation endpoint for the full request schema.

The proportional profit is calculated automatically and returned in the organisation response. It reflects the cumulative effect of all parent organisation shares.

📘

Profit share is optional

If you prefer to handle revenue sharing on your side and don’t need ekko to report on it, you can leave relativeProfitShare at the default of 0 for your child organisations. The service fee is still applied, but the split won’t appear in profit share reconciliation records.

Sales tax

The API provides sales tax amounts and rates for both the service fee and the impact amount.

These fields support jurisdictions that require consumer-facing tax breakdowns.