Bulk create bills

POST/api/v1/bills/bulk

Create multiple bills from CSV data in a single request.

Operation ID: create_bulk_bills_api_v1_bills_bulk_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

s3_keystring

S3 key of the uploaded CSV file containing bill data.

approveboolean

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

create_as_receivedboolean

If true, every row is created in 'received' status with an accounting journal entry. Each row must have a resolvable expense ledger (ledger_id, ledger_name, or expense_account column) and a valid amount. Overrides approve when set.

attachmentsobject

Optional mapping of source filename → pre-uploaded S3 key (from POST /bills/upload). Rows whose attachment_filename matches a key in this map have the corresponding document attached.

Responses

201Successful Response

successboolean
messagestring
codestring
dataBillsListResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

422Validation Error

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