Account general billing instructions

BillingCenter Cloud API provides the ability to send general billing instructions for accounts and for policy periods. General billing instructions are “catch-all” general-purpose billing instructions for existing policies and accounts.

To issue an account general billing instruction, use the following endpoint:

POST /billing/v1/accounts/{accountId}/general-billing-instructions

You can post an account general billing instruction to update account data and create charges on the account.

The only required field is billingInstructionDate. This is a string, formatted as a date-time value YYYY-MM-DD.

Fields for account general billing instructions

The only required field is billingInstructionDate. This is a string, formatted as a date-time value YYYY-MM-DD. You can also specify the following optional fields:


Field	Data type	Note
`charges`	Array of `charge` objects	Each charge object requires an `amount` and a `chargePattern`. You can only include charges with specific charge patterns in account general billing instructions: The `chargeCategory` has to be either `fee` or `general`. The charge pattern’s `tAccountOwnerType` must be `Account`.
`description`	String in the date-time format `YYYY-MM-DD`

Example

The following example demonstrates POSTing an account general billing instruction. This adds an account-level charge to the account.

Command

POST /billing/v1/accounts/bc:1221/general-billing-instructions

Request body

{
  "data": {
    "attributes": {
      "billingInstructionDate": "2025-10-10",
      "charges": [
        {
          "amount": {
            "amount": "100",
            "currency": "usd"
          },
          "chargePattern": {
            "id": "default_data:5"
          }
        }
      ]
    }
  }
}

The request returns an account billing instruction object consisting of account data, charge data, and data about the billing instruction itself.