POST v1/Commissions/AgencyRules/Update

Adds or updates a commission rule for the agency

Request Information

URI Parameters

None.

Body Parameters

Agency Commissions rule

CommRuleAgencyDto
NameDescriptionTypeAdditional information
CommApplyAllLines

Indicates if all lines are applied

boolean

None.

PremiumTier

Type of premium tier

integer

None.

RuleEntries

List of rule entries

Collection of CommRuleAgencyEntryDto

None.

RuleId

The ID of the rule

integer

None.

PolicyType

Type of the policy

EnumPolicyType

None.

PackageType

Type of the package

EnumPackageType

None.

Term

The term of the policy

EnumPolicyTerm

None.

OfficeId

The ID of the office

integer

None.

MgaId

The ID of the MGA

integer

None.

ParentCarrierId

The ID of the parent carrier

integer

None.

CarrierId

The ID of the carrier

integer

None.

SublineId

The ID of the subline

integer

None.

LobId

The ID of the line of business

integer

None.

PackageLobId

LOB of the Selected Package, if the rule is for a package

integer

None.

RuleWeight

The weight of the rule

integer

None.

EffectiveOn

The effective date of the rule

date

None.

ExpiresOn

The date when the rule will expire

date

None.

OfficeName

The name of the office for displaying on the UI

string

None.

CarrierName

The name of the carrier for displaying on the UI

string

None.

ParentCarrierName

The name of the parent carrier for displaying on the UI

string

None.

MgaName

The name of the MGA for displaying on the UI

string

None.

SublineName

The name of the subline for displaying on the UI

string

None.

LobName

The name of the line of business for displaying on the UI

string

None.

LobList

The list of the lines of business for displaying on the UI

Collection of CommRuleLobListItemDto

None.

Request Formats

application/json, text/json

Sample:
{
  "CommApplyAllLines": true,
  "PremiumTier": 2,
  "RuleEntries": [
    {
      "EntryId": 1,
      "LobId": 1,
      "NewBusiness": 2.0,
      "Renewal": 3.0,
      "Rewrite": 4.0,
      "TierMax": 5.0,
      "RuleEntryIsPercent": true,
      "LobName": "sample string 7",
      "LobInternalCode": "sample string 8"
    },
    {
      "EntryId": 1,
      "LobId": 1,
      "NewBusiness": 2.0,
      "Renewal": 3.0,
      "Rewrite": 4.0,
      "TierMax": 5.0,
      "RuleEntryIsPercent": true,
      "LobName": "sample string 7",
      "LobInternalCode": "sample string 8"
    }
  ],
  "RuleId": 3,
  "PolicyType": 0,
  "PackageType": 0,
  "Term": 0,
  "OfficeId": 1,
  "MgaId": 1,
  "ParentCarrierId": 1,
  "CarrierId": 1,
  "SublineId": 1,
  "LobId": 1,
  "PackageLobId": 1,
  "RuleWeight": 4,
  "EffectiveOn": "2026-08-25T17:22:17.9027343+00:00",
  "ExpiresOn": "2026-08-25T17:22:17.9027343+00:00",
  "OfficeName": "sample string 5",
  "CarrierName": "sample string 6",
  "ParentCarrierName": "sample string 7",
  "MgaName": "sample string 8",
  "SublineName": "sample string 9",
  "LobName": "sample string 10",
  "LobList": [
    {
      "ID": 1,
      "Name": "sample string 2"
    },
    {
      "ID": 1,
      "Name": "sample string 2"
    }
  ]
}

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'CommRuleAgencyDto'.

application/xml, text/xml

Sample:
<CommRuleAgencyDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/QQSolutions.NextGen.ModelLibrary.DataTransferObjects.CommissionCentral">
  <CarrierId>1</CarrierId>
  <CarrierName>sample string 6</CarrierName>
  <EffectiveOn>2026-08-25T17:22:17.9027343+00:00</EffectiveOn>
  <ExpiresOn>2026-08-25T17:22:17.9027343+00:00</ExpiresOn>
  <LobId>1</LobId>
  <LobList>
    <CommRuleLobListItemDto>
      <ID>1</ID>
      <Name>sample string 2</Name>
    </CommRuleLobListItemDto>
    <CommRuleLobListItemDto>
      <ID>1</ID>
      <Name>sample string 2</Name>
    </CommRuleLobListItemDto>
  </LobList>
  <LobName>sample string 10</LobName>
  <MgaId>1</MgaId>
  <MgaName>sample string 8</MgaName>
  <OfficeId>1</OfficeId>
  <OfficeName>sample string 5</OfficeName>
  <PackageLobId>1</PackageLobId>
  <PackageType>Personal</PackageType>
  <ParentCarrierId>1</ParentCarrierId>
  <ParentCarrierName>sample string 7</ParentCarrierName>
  <PolicyType>Monoline</PolicyType>
  <RuleId>3</RuleId>
  <RuleWeight>4</RuleWeight>
  <SublineId>1</SublineId>
  <SublineName>sample string 9</SublineName>
  <Term>Annual</Term>
  <CommApplyAllLines>true</CommApplyAllLines>
  <PremiumTier>2</PremiumTier>
  <RuleEntries>
    <CommRuleAgencyEntryDto>
      <EntryId>1</EntryId>
      <LobId>1</LobId>
      <LobInternalCode>sample string 8</LobInternalCode>
      <LobName>sample string 7</LobName>
      <NewBusiness>2</NewBusiness>
      <Renewal>3</Renewal>
      <Rewrite>4</Rewrite>
      <RuleEntryIsPercent>true</RuleEntryIsPercent>
      <TierMax>5</TierMax>
    </CommRuleAgencyEntryDto>
    <CommRuleAgencyEntryDto>
      <EntryId>1</EntryId>
      <LobId>1</LobId>
      <LobInternalCode>sample string 8</LobInternalCode>
      <LobName>sample string 7</LobName>
      <NewBusiness>2</NewBusiness>
      <Renewal>3</Renewal>
      <Rewrite>4</Rewrite>
      <RuleEntryIsPercent>true</RuleEntryIsPercent>
      <TierMax>5</TierMax>
    </CommRuleAgencyEntryDto>
  </RuleEntries>
</CommRuleAgencyDto>

Response Information

Resource Description

Agency Commissions rule id

ActionResultDTOOfInt32
NameDescriptionTypeAdditional information
Result

integer

None.

CreatedBy

string

None.

EntityID

integer

None.

RowSource

string

None.

PolicyID

integer

None.

IsSuccess

Signifies whether action is successful

boolean

None.

ErrorCode

Error code

string

None.

ErrorMessage

Error message

string

None.

InfoMessage

Information message

string

None.

Response Formats

application/json, text/json

Sample:
{
  "Result": 1,
  "CreatedBy": "sample string 2",
  "EntityID": 3,
  "RowSource": "sample string 4",
  "PolicyID": 5,
  "IsSuccess": true,
  "ErrorCode": "sample string 7",
  "ErrorMessage": "sample string 8",
  "InfoMessage": "sample string 9"
}

application/xml, text/xml

Sample:
<ActionResultOfint xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/QQSolutions.NextGen.ModelLibrary.DataTransferObjects">
  <ErrorCode>sample string 7</ErrorCode>
  <ErrorMessage>sample string 8</ErrorMessage>
  <InfoMessage>sample string 9</InfoMessage>
  <IsSuccess>true</IsSuccess>
  <CreatedBy>sample string 2</CreatedBy>
  <EntityID>3</EntityID>
  <PolicyID>5</PolicyID>
  <Result>1</Result>
  <RowSource>sample string 4</RowSource>
</ActionResultOfint>