Create multiple bills

Create multiple bills with one API request. You can create up to 200 bills with one POST /v3/bills/bulk request.

Bulk bill creation at BILL follow a set of rules.

  • Successful response: In your bulk bill creation request, all your bills must be successfully created for a successful response. If any bill creation is not successful, the entire request fails and none of the bills in the request are created.
  • You can create bills for multiple vendors: You can create bills for one vendor or for multiple vendors with one POST /v3/bills/bulk request.

See Bills in the Guides section for more information, sample requests, and responses.

Body Params
Headers
string | null

API session ID generated with /v3/login

string | null

Developer key sent to you by BILL when you create a developer account

Responses

Response body
array of objects
object
string
required

BILL-generated ID of the bill. The value begins with 00n.

boolean
required

Set as true if the bill is archived

string
required

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

number

Bill amount. This value is in USD.

number

Bill amount. For a bill in an international currency (not USD), this value is in the local currency.

number

Exchange rate for the bill amount in an international currency (not USD).

The BILL exchange rate changes periodically and a different rate may apply at the time of payment.

string

Bill description

date

Bill due date. The value is in the yyyy-MM-dd format.

object

Invoice information

array of objects

Bill line item information

billLineItems
object
string

BILL-generated ID of the bill line item. The value begins with bli.

number
required

Bill line item amount. For a bill in an international currency (not USD), this value is in the local currency.

string

Bill line item description

string

BILL-generated ID of the chart of accounts for the bill line item. The value begins with 0ca.

string

BILL-generated ID of the chart of accounts for the bill payment. The value begins with 0ca.

string

Bill payment status.

PAID UNPAID PARTIALLY_PAID SCHEDULED IN_PROCESS UNDEFINED

date-time

Created date and time

date-time

Updated date and time

Language
Click Try It! to start a request and see the response here! Or choose an example:
application/json