---
title: "List revenue-share policies"
method: GET
path: "/api/v1/revenue-share/policies"
tags: ["Revenue Share"]
---

# List revenue-share policies

`GET /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

Required scope: `revenue-share:read`

## Query parameters

- `page` integer
- `perPage` integer
- `status` 'Draft' | 'Active'
- `kind` 'team_to_team' | 'operator_to_team'
- `moneyFlow` 'wallet_live' | 'wallet_monthly' | 'external'
- `search` string, nullable: Free-text match on code, name or description.
- `includeDeleted` boolean, nullable: Include soft-deleted policies in the results.

## Response `200`

Revenue-share policies matching the filters

- OffsetBasedResponse50
  - `data` RevenueSharePolicy[], required
    - `code` string, required: Stable code identifying the policy.
    - `name` string, required: Human-readable name.
    - `description` string, nullable: Optional internal description.
    - `kind` 'team_to_team' | 'operator_to_team', required
    - `seller` 'cpo' | 'site_owner', required
    - `policyType` 'percentage' | 'per_kwh', required
    - `policyValue` number, required: The share value: a percentage of net, or an amount per kWh.
    - `moneyFlow` 'wallet_live' | 'wallet_monthly' | 'external', required
    - `status` 'Draft' | 'Active', required
    - `version` integer: Policy version.
    - `validFrom` string, date-time, nullable: Start of the validity window.
    - `validTo` string, date-time, nullable: End of the validity window.
    - `createdAt` string, date-time, nullable: Creation timestamp.
    - `updatedAt` string, date-time, nullable: Last update timestamp.
    - `deletedAt` string, date-time, nullable: Soft-delete timestamp, null when the policy is not deleted.
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400`: The request is invalid
- `401`: Consumer with provided credentials was not found
- `403`: Operator doesn't have access to resource
- `404`: Entity with the provided id was not found

## Changes

- **2026-11-03** `0ca400461c52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monta/apis/monta-partner-api/changes/api/v1/revenue-share/policies/get.md)

---

[API](https://skmtc.dev/monta/apis/monta-partner-api.md) - [All operations](https://skmtc.dev/monta/apis/monta-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monta/apis/monta-partner-api/revisions/0ca400461c52?raw)