v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB

vendor-credits

Create multiple vendor credits

Create multiple vendor credits with one API request. You can create up to 50 vendor credits with one POST /v3/vendor-credits/bulk request.

post/v3/vendor-credits/bulk

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 required

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

referenceNumberstring required

User-generated vendor credit number. This value can be in your chosen number scheme.

creditDatestring date required

Vendor credit issued date. This value is in the yyyy-MM-dd format.

descriptionstring

Vendor credit description

applyToChartOfAccountIdstring

BILL-generated ID of the chart of accounts used when the vendor credit is applied to a bill payment. The value begins with 0ca.

applyToBankAccountIdstring

BILL-generated ID of the bank account used when the vendor credit is applied to a bill payment. The value begins with bac.

Note: You can set only one of applyToChartOfAccountId or applyToBankAccountId.

Example request

[
  {
    "vendorId": "{{vendor_id}}",
    "referenceNumber": "202602-vendorcredit",
    "creditDate": "2026-12-28",
    "vendorCreditLineItems": [
      {
        "description": "Classic extreme drum sticks",
        "amount": 14.99
      },
      {
        "description": "Metal guitar picks (5-pack)",
        "amount": 50
      }
    ],
    "description": "Happy Vendor Credit"
  }
]

Response

Create multiple vendor credits response