> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Get a specific setting - Billing Rules

> Learn how to retrieve the Billing Rules settings by the Settings API.

Learn how to retrieve the Billing Rules settings by the Settings API.

Use the [List all settings](https://developer.zuora.com/v1-api-reference/api/operation/GET_ListAllSettings/) operation to retrieve all the available settings and supported operations of them.

Search for "Billing Rules" and find the following information from the response body of the "List all settings" call.

```json
{
  "settings": [
    ...,
    {
      "key": "BillingRules",
      "description": "Billing Rules settings",
      "context": "Entity",
      "pathPattern": "/billing-rules",
      "httpOperations": [
        {
          "method": "GET",
          "url": "/settings/billing-rules",
          "parameters": [],
          "responseType": {
            "$ref": "#/definitions/BillingRules",
            "definitions": {
              "BillingRules": {
                "additionalProperties": false,
                "type": "object",
                "properties": {
                  "includeNegativeInvoice": {
                    "type": "boolean"
                  },
                  "prorationUnit": {
                    "type": "string",
                    "enum": [
                      "ProrateByDay",
                      "ProrateByMonthFirst"
                    ]
                  },
                  "prorateUsageWeeklyCharges": {
                    "type": "boolean"
                  },
                  "preGenerateInvoicePdf": {
                    "type": "boolean"
                  },
                  "notSendZeroItemsForTax": {
                    "type": "boolean"
                  },
                  "availableToCreditValidationLevel": {
                    "type": "string"
                  },
                  "timeOfDailyInvoice": {
                    "maximum": 23,
                    "type": "integer",
                    "minimum": 0
                  },
                  "invoicePastEndOfTerm": {
                    "description": "Invoice Past End-of-Term when Auto-Renew is OFF",
                    "type": "boolean"
                  },
                  "oneTimeCreditBack": {
                    "type": "boolean"
                  },
                  "taxInclusiveRoundingRule": {
                    "type": "string",
                    "enum": [
                      "RoundingNetAmount",
                      "RoundingTaxAmount"
                    ]
                  },
                  "billToTermEndWhenAutoRenew": {
                    "description": "Invoice Past End-of-Term when Auto-Renew is ON",
                    "type": "boolean"
                  },
                  "includeChildUsage": {
                    "type": "boolean"
                  },
                  "allowAutoPostBillRun": {
                    "type": "boolean"
                  },
                  "taxAddressOwner": {
                    "type": "string",
                    "enum": [
                      "SubscriptionOwner",
                      "InvoiceOwner"
                    ]
                  },
                  "recurringChargeStyle": {
                    "type": "string",
                    "enum": [
                      "Advanced",
                      "Arrears",
                      "DependsOnRatePlan"
                    ]
                  },
                  "prorateUsageMonthlyCharges": {
                    "type": "boolean"
                  },
                  "takeContactSnapshot": {
                    "type": "boolean"
                  },
                  "autoPostBillRunDefaultValue": {
                    "type": "boolean"
                  },
                  "prorateRecurringMonthlyCharges": {
                    "type": "boolean"
                  },
                  "proratePeriodOfRecurringCharge": {
                    "description": "Prorate recurring charges for partial period",
                    "type": "boolean"
                  },
                  "daysInMonth": {
                    "type": "string",
                    "enum": [
                      "Assume30Days",
                      "UseActualDays"
                    ]
                  },
                  "legalDocumentGeneratingRule": {
                    "type": "string",
                    "enum": [
                      "GroupbyChargedAmountSign",
                      "GroupByOriginalSRPC",
                      "GroupByTotalAmountSign"
                    ]
                  },
                  "prorateRecurringWeeklyCharges": {
                    "type": "boolean"
                  },
                  "transactionOnSubscription": {
                    "type": "boolean"
                  },
                  "numberAssignmentTiming": {
                    "type": "string"
                  },
                  "taxRateChangeOption": {
                    "type": "string"
                  },
                  "rateUsageIndividually": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        ...
      ]
    }
  ]
}
```

You can find the following information about the Billing Rules setting:

* GET operation endpoint of for Billing Rules setting: `"url": "/settings/billing-rules"`
* The response schema:

  ```
  "BillingRules": {
    "additionalProperties": false,
    "type": "object",
    "properties": {
      "includeNegativeInvoice": {
        "type": "boolean"
      },
      "prorationUnit": {
        "type": "string",
        "enum": [
          "ProrateByDay",
          "ProrateByMonthFirst"
        ]
      },
      "prorateUsageWeeklyCharges": {
        "type": "boolean"
      },
      "preGenerateInvoicePdf": {
        "type": "boolean"
      },
      "notSendZeroItemsForTax": {
        "type": "boolean"
      },
      "availableToCreditValidationLevel": {
        "type": "string"
      },
      "timeOfDailyInvoice": {
        "maximum": 23,
        "type": "integer",
        "minimum": 0
      },
      "invoicePastEndOfTerm": {
        "description": "Invoice Past End-of-Term when Auto-Renew is OFF",
        "type": "boolean"
      },
      "oneTimeCreditBack": {
        "type": "boolean"
      },
      "taxInclusiveRoundingRule": {
        "type": "string",
        "enum": [
          "RoundingNetAmount",
          "RoundingTaxAmount"
        ]
      },
      "billToTermEndWhenAutoRenew": {
        "description": "Invoice Past End-of-Term when Auto-Renew is ON",
        "type": "boolean"
      },
      "includeChildUsage": {
        "type": "boolean"
      },
      "allowAutoPostBillRun": {
        "type": "boolean"
      },
      "taxAddressOwner": {
        "type": "string",
        "enum": [
          "SubscriptionOwner",
          "InvoiceOwner"
        ]
      },
      "recurringChargeStyle": {
        "type": "string",
        "enum": [
          "Advanced",
          "Arrears",
          "DependsOnRatePlan"
        ]
      },
      "prorateUsageMonthlyCharges": {
        "type": "boolean"
      },
      "takeContactSnapshot": {
        "type": "boolean"
      },
      "autoPostBillRunDefaultValue": {
        "type": "boolean"
      },
      "prorateRecurringMonthlyCharges": {
        "type": "boolean"
      },
      "proratePeriodOfRecurringCharge": {
        "description": "Prorate recurring charges for partial period",
        "type": "boolean"
      },
      "daysInMonth": {
        "type": "string",
        "enum": [
          "Assume30Days",
          "UseActualDays"
        ]
      },
      "legalDocumentGeneratingRule": {
        "type": "string",
        "enum": [
          "GroupbyChargedAmountSign",
          "GroupByOriginalSRPC",
          "GroupByTotalAmountSign"
        ]
      },
      "prorateRecurringWeeklyCharges": {
        "type": "boolean"
      },
      "transactionOnSubscription": {
        "type": "boolean"
      },
      "numberAssignmentTiming": {
        "type": "string"
      },
      "taxRateChangeOption": {
        "type": "string"
      },
      "rateUsageIndividually": {
        "type": "boolean"
      }
    }
  }
                              
  ```

Make GET call at the endpoint `/settings/billing-rules`.

HTTP request:

`GET https://rest.zuora.com/settings/billing-rules`

Response body:

See the following example for the 200 response body.

```json
{
  "oneTimeCreditBack": false,
  "proratePeriodOfRecurringCharge": true,
  "prorateRecurringWeeklyCharges": true,
  "prorateRecurringMonthlyCharges": true,
  "prorateUsageMonthlyCharges": true,
  "prorateUsageWeeklyCharges": true,
  "daysInMonth": "UseActualDays",
  "prorationUnit": "ProrateByDay",
  "allowAutoPostBillRun": true,
  "autoPostBillRunDefaultValue": true,
  "includeNegativeInvoice": true,
  "includeChildUsage": true,
  "rateUsageIndividually": true,
  "transactionOnSubscription": true,
  "taxAddressOwner": "SubscriptionOwner",
  "takeContactSnapshot": true,
  "taxInclusiveRoundingRule": "RoundingNetAmount",
  "legalDocumentGeneratingRule": "GroupByOriginalSRPC",
  "recurringChargeStyle": "Advanced",
  "preGenerateInvoicePdf": false,
  "timeOfDailyInvoice": 0,
  "notSendZeroItemsForTax": false,
  "taxRateChangeOption": "OneTaxItem",
  "availableToCreditValidationLevel": "HeaderLevel",
  "invoicePastEndOfTerm": false,
  "billToTermEndWhenAutoRenew": true,
  "zuoraTaxRoundingDiffDispersion": false,
  "numberAssignmentTiming": "Generating",
  "creditMemoMirroringInvoiceItemsRule": "YesExceptForZeroItems", 
  "debookRebookSupportable": false,
  "allowIndistinctMapping": false,
  "invoiceSplit": false,
  "sequentialInvoiceNumber": false,
  "consolidateInvoices": false,
  "discountCreditProration": false,
  "zuoraNumberFormatForMergeField": false
}
```