BIbill
recurringbills

Update a recurring bill

Changed on

Update details about a recurring bill line item. You can also update other recurring bill details.

You can use the PATCH operation to modify line item details, such as amount and description. The recurring bill line item id does not change with a PATCH operation.

When a recurring bill is modified, all future bills are automatically changed.

patch/v3/recurringbills/{recurringBillId}

Request

  • Base URL
    https://gateway.stage.bill.com/connect
  • URL
    https://gateway.stage.bill.com/connect/v3/recurringbills/{recurringBillId}
  • Auth
    none declared

Path parameters

recurringBillIdstring required

BILL-generated ID of the recurring bill. The value begins with btp.

Example:{{recurring_bill_id}}

Headers

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}
devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Request body

vendorIdstring

BILL-generated ID of the vendor. The value begins with 009.

descriptionstring

User-generated invoice number. This value can be your chosen number scheme or bill due date.

Example request

{
  "recurringBillLineItems": [
    {
      "id": "{{recurring_bill_line_item_id01}}",
      "amount": 22.99,
      "description": "Monthly subscription (amount updated)",
      "quantity": 1
    }
  ]
}

Response

Update a recurring bill response

idstring required

BILL-generated ID of the recurring bill. The value begins with btp.

archivedboolean required

Set as true if the recurring bill is archived

vendorIdstring required

BILL-generated ID of the vendor. The value begins with 009.

descriptionstring

Recurring bill description

billsCountinteger required

Number of bills generated from this recurring bill

amountnumber

Recurring bill total amount

expiredboolean required

Set as true if the recurring bill is expired

createdTimestring date-time

Created date and time

updatedTimestring date-time

Updated date and time

Changes

  • 54edddceb0a5Revision changes
    • info

      added the new optional request property /////

    • info

      added the new optional request property ///////

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the optional property to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status