Start free trial

Create an upcoming bill (optionally recurring)

POST/api/v1/bills/upcoming

Create one expected bill, or a recurring series. A recurring request materialises every projected occurrence up front (capped by recurrence.occurrences), so each one can be edited, deleted or matched independently. Returns every occurrence created.

Operation ID: create_upcoming_bill_api_v1_bills_upcoming_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Request body

Schema: UpcomingBillCreateRequest

vendor_idstring

Vendor this is expected from, when one exists.

vendor_namestring

Payee name when there is no vendor record yet.

descriptionstring

What the bill is for.

estimated_amountintegerrequired

Estimated amount in cents. An estimate, not a payable.

expected_datestring · daterequired

When the bill is expected (first occurrence for a series).

notesstring

Free-form notes.

recurrenceUpcomingBillRecurrence

Omit for a single expected bill.

Responses

201Successful Response

Schema: SuccessEnvelope_UpcomingBillListResponse_

successboolean
messagestring
codestring
dataUpcomingBillListResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject