Bill

A bill created in Bookkeep from one or more receipts and posted to the merchant's accounting platform. Bills are read-only through this API.

uuidstring

The bill's unique identifier. Use it in the bill path.

Example: 5e6f7a8b-9c0d-4e2f-8a4b-5c6d7e8f9a0b

bkapp_organization_idstring

The Entity ID the bill belongs to, the same value as {entity_id} in the path.

Example: a1b2c3d4e5

vendor_identifierstring

The vendor in the merchant's accounting platform that the bill is posted to, as that platform identifies it.

Example: 58

currency_codestring

Example: USD

txn_datestring<date>

The bill date.

Example: 2026-09-17

bill_numberstring

Example: BILL-1001

due_datestring<date>

Example: 2026-10-17

memostringnullable

Example: null

note_to_supplierstringnullable

Example: null

total_amountnumbernullable

Bill total, in currency_code.

Example: 162.38

statestring

One of draft, posting, posted, post_failed, update_failed, delete_failed or deleted. posted means the bill is in the accounting platform.

Example: posted

created_atstring<date-time>

Example: 2026-09-17T14:10:02.000Z

updated_atstring<date-time>

Example: 2026-09-17T14:10:09.000Z

purchase_order_receipts object[]

Present only when include=purchase_order_receipts was requested.

Array [

uuidstring

Example: 3f2a9c1e-2b3d-4c5e-8f6a-1b2c3d4e5f60

]

Bill

{
  "uuid": "5e6f7a8b-9c0d-4e2f-8a4b-5c6d7e8f9a0b",
  "bkapp_organization_id": "a1b2c3d4e5",
  "vendor_identifier": "58",
  "currency_code": "USD",
  "txn_date": "2026-09-17",
  "bill_number": "BILL-1001",
  "due_date": "2026-10-17",
  "memo": null,
  "note_to_supplier": null,
  "total_amount": 162.38,
  "state": "posted",
  "created_at": "2026-09-17T14:10:02.000Z",
  "updated_at": "2026-09-17T14:10:09.000Z",
  "purchase_order_receipts": [
    {
      "uuid": "3f2a9c1e-2b3d-4c5e-8f6a-1b2c3d4e5f60"
    }
  ]
}