MOmonta
Revenue Share

Create a revenue-share policy

Changed on

Required scope: revenue-share:write. The policy is created in Draft status.

post/api/v1/revenue-share/policies

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/revenue-share/policies
  • Auth
    HTTP bearer

Request body

namestring required

Human-readable name.

descriptionstring nullable

Optional internal description.

kind'team_to_team' | 'operator_to_team' required
seller'cpo' | 'site_owner' required
policyType'percentage' | 'per_kwh' required
policyValuenumber required

The share value: a percentage of net, or an amount per kWh.

moneyFlow'wallet_live' | 'wallet_monthly' | 'external' required
validFromstring date-time required

Start of the validity window.

validTostring date-time nullable

Optional end of the validity window.

Example request

{
  "name": "Fleet 85/15",
  "policyValue": 15,
  "validFrom": "2026-01-01T00:00:00Z",
  "validTo": "2026-12-31T23:59:59Z"
}

Response

The created revenue-share policy

codestring required

Stable code identifying the policy.

namestring required

Human-readable name.

descriptionstring nullable

Optional internal description.

kind'team_to_team' | 'operator_to_team' required
seller'cpo' | 'site_owner' required
policyType'percentage' | 'per_kwh' required
policyValuenumber required

The share value: a percentage of net, or an amount per kWh.

moneyFlow'wallet_live' | 'wallet_monthly' | 'external' required
status'Draft' | 'Active' required
versioninteger

Policy version.

validFromstring date-time nullable

Start of the validity window.

validTostring date-time nullable

End of the validity window.

createdAtstring date-time nullable

Creation timestamp.

updatedAtstring date-time nullable

Last update timestamp.

deletedAtstring date-time nullable

Soft-delete timestamp, null when the policy is not deleted.

Example response

{
  "code": "P-ACME-3",
  "name": "Fleet 85/15",
  "policyValue": 15,
  "version": 1,
  "validFrom": "2026-01-01T00:00:00Z",
  "validTo": "2026-12-31T23:59:59Z"
}

Changes