Start free trial

Create bill

POST/api/v1/bills

Create a new bill in draft status. Optionally include 'recurring' config to also create a recurring template.

Operation ID: create_bill_api_v1_bills_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: BillCreateRequest

descriptionstring

Description of what the bill is for.

currencystring

Currency for the bill (USD, CAD, AUD, EUR, or GBP). Defaults to business default.

vendor_idstring

UUID of the vendor this bill is from.

bill_numberstring

Bill/invoice number from the vendor. Auto-generated if not provided.

typestring

Bill type: 'recurring' (monthly rent, subscriptions) or 'one_time'.

expected_amountinteger

Expected bill amount in cents.

expected_paid_on_datestring · date-time | string

Expected payment date (ISO 8601 format).

s3_keystring

S3 key of uploaded bill document (PDF/image).

recurringRecurringConfig

If provided, creates a recurring template for this bill.

submitted_for_reviewboolean

When true, marks this draft as a client-submitted expense and notifies the assigned advisor to confirm or deny it.

Responses

201Successful Response

Schema: SuccessEnvelope_BillResponse_

successboolean
messagestring
codestring
dataBillResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

422Validation Error

Schema: HTTPValidationError

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