Bulk create bills — bills

Request body

Schema: BillBulkRequest

s3_key string

S3 key of the uploaded CSV file containing bill data.

approve boolean

If true, created bills are set to 'forecasted' status (approved). If false, bills remain as 'draft'.

Responses

201 Successful Response

Schema: BillsListResponse

items array · BillResponse requiredBillResponse

List of items

25 fields

id string required: Bill UUID.
business_id string required: Business UUID.
currency string: Currency for the bill (USD, CAD, AUD, EUR, or GBP).
status integer | string required: Bill status (see schema description).
description string: Bill description.
bill_number string: Bill/invoice number from vendor.
vendor_id string required: Vendor UUID.
vendor_name string: Vendor name (resolved).
vendor_email string: Vendor email (resolved).
type integer | string required: Type: 'recurring' or 'one_time'.
expected_amount integer: Expected amount in cents.
expected_paid_on_date string · date-time: Expected payment date.
total_paid integer: Total amount paid so far in cents.
amount integer: Actual bill amount in cents.
s3_key string: S3 key of attached document.
received_on string · date-time: Date bill/goods received.
due_on string · date-time: Payment due date.
paid_on string · date-time: Date fully paid.
created_at string · date-time required: Creation timestamp.
updated_at string · date-time required: Last update timestamp.
signed_url string: Signed URL to view attached document.
payments array · object: List of payments made.
journal_entries array · object: Associated accounting entries.
recurring_template_id string: ID of recurring template if this bill was generated from one, or if one was created.
source_inventory_order_id string: Source PO that produced this bill via the PO lifecycle. Non-null means this bill is visible on the Inventory -> Accounts Payable tab.

total integer

Total number of items (null when not calculated for performance)

limit integer

Pagination limit

next_cursor string

Cursor for next page

prev_cursor string

Cursor for previous page

has_next boolean required

Whether there are more items

has_prev boolean required

Whether there are previous items

400 Bad Request - Invalid input

401 Unauthorized - Authentication required

403 Forbidden - Insufficient permissions

422 Validation Error

Schema: HTTPValidationError

detail array · ValidationError ValidationError

5 fields

loc array · string | integer required
msg string required
type string required
input object
ctx object

curl -X POST 'https://api.ondayzero.com/api/v1/bills/bulk' \ -H 'Authorization: Bearer dz_your_token' \ -H 'x-business-id: YOUR_BUSINESS_ID' \ -H 'Content-Type: application/json' \ -d '{ "s3_key": "string", "approve": false }'