Item commissions

An item commission is a collection of information about the commission to be earned and paid for a specific invoice item. Each charge commission contains one or more item commissions, and every item commission maps directly to an invoice item.

You can retrieve item commissions using the following Cloud API endpoints:

• GET /producers/{producerId}/producer-codes/{producerCodeId}/policy-commissions/{policyCommissionId}/charge-commissions/{chargeCommissionId}/item-commissions
• GET /producers/{producerId}/producer-codes/{producerCodeId}/policy-commissions/{policyCommissionId}/charge-commissions/{chargeCommissionId}/item-commissions/{itemCommissionId}

Cloud API returns the calculated values for item commissions by default. Each item commission contains references to the parent charge commission and policy commission, as well as the associated invoice item.

For example, the following call retrieves a single item commission:

Command

GET /billing/v1/producers/bc:bc:188/producer-codes/bc:195/policy-commissions/bc:217/charge-commissions/bc:63919/item-commissions/bc:63920

Response

{
    "data": {
        "attributes": {
            "active": true,
            "agencyBillRetained": {
                "amount": "0.00",
                "currency": "usd"
            },
            "chargeCommission": {
                "displayName": "Producer code Galaxy-96-Record (PC-1752616407580) with role Primary on policy PP-Bungalow-101-Parachute-1 for charge Premium (Policy Issuance)",
                "id": "bc:63919",
                "type": "ChargeCommission",
                "uri": "/billing/v1/producers/bc:bc:188/producer-codes/bc:195/policy-commissions/bc:217/charge-commissions/bc:63919"
            },
            "commissionAmount": {
                "amount": "10.00",
                "currency": "usd"
            },
            "currency": {
                "code": "usd",
                "name": "USD"
            },
            "directBillEarned": {
                "amount": "0.00",
                "currency": "usd"
            },
            "id": "bc:63920",
            "invoiceItem": {
                "displayName": "07/15/2025 ($100.00)",
                "id": "bc:S403bKQ9g6Fjftk1bsGz-",
                "type": "InvoiceItem",
                "uri": "/billing/v1/charges/bc:Si4BAIY-HNNKm7PBIcKA4/invoice-items/bc:S403bKQ9g6Fjftk1bsGz-"
            },
            "payableCriteria": {
                "code": "binding",
                "name": "On Binding"
            },
            "policyCommission": {
                "displayName": "Producer code Galaxy-96-Record (PC-1752616407580) with role Primary on policy PP-Bungalow-101-Parachute-1",
                "id": "bc:Sv_7Pv2LVPwieM0kn4-s-",
                "type": "PolicyCommission",
                "uri": "/billing/v1/producers/bc:bc:188/producer-codes/bc:195/policy-commissions/bc:217"
            },
            "reversed": false,
            "writtenOffCommission": {
                "amount": "0.00",
                "currency": "usd"
            }
        },
        ...
    }
}