Ramp: Update a bill — request body — body

API reference · Contract 2026-10-27

SDK schema: Update a bill — request body — body

Field	Type	Presence	Description and constraints
$	object	Root
accounting_field_selections	array	Optional	List of accounting field options selected to code the bill.
accounting_field_selections[]	Model	Each item	Expand Create a bill — request body — body accounting field selections item
due_at	string	Optional	Due date of the bill. Format: date
entity_id	string	Optional	Associated business entity. Format: uuid
inventory_line_items	JSON	Optional
inventory_line_items (anyOf 1)	array	Alternative	List of inventory line items associated with the bill. When provided, this will replace all existing inventory line items.
inventory_line_items (anyOf 1)[]	Model	Each item	Expand Update a bill — request body — body inventory line items array item
inventory_line_items (anyOf 2)	null	Alternative
invoice_number	string	Optional	The invoice number on the bill. Maximum length: 84
issued_at	string	Optional	Issued date of the bill. Format: date
line_items	JSON	Optional
line_items (anyOf 1)	array	Alternative	List of line items related to the bill. When provided, this will replace all existing line items.
line_items (anyOf 1)[]	Model	Each item	Expand Update a bill — request body — body line items array item
line_items (anyOf 2)	null	Alternative
memo	JSON	Optional
memo (anyOf 1)	string	Alternative	Memo of the bill. Maximum length: 1000
memo (anyOf 2)	null	Alternative
payment_date	JSON	Optional
payment_date (anyOf 1)	string	Alternative	For non-card payment methods, the date the payment is scheduled to be initiated. If the requested date is unavailable, such as a weekend, bank holiday, past date, or same-day cutoff miss, Ramp schedules the payment for the next available initiation date. Set to null to unschedule the payment. Format: date
payment_date (anyOf 2)	null	Alternative
payment_method	string	Optional	Payment method of the bill. One of: ACH, CARD, CHECK, CRYPTO_WALLET_TRANSFER, DOMESTIC_WIRE, INTERNATIONAL, LOCAL_BANK_TRANSFER, ONE_TIME_CARD, ONE_TIME_CARD_DELIVERY, PAID_MANUALLY, SWIFT
posting_date	JSON	Optional
posting_date (anyOf 1)	string	Alternative	The date the bill is posted to the accounting system. Format: date
posting_date (anyOf 2)	null	Alternative
purchase_order_ids	array	Optional	Unique identifiers of the purchase orders to match this bill to. When provided, this will replace all existing linked purchase orders.
purchase_order_ids[]	string	Each item	Format: uuid
remote_id	JSON	Optional
remote_id (anyOf 1)	string	Alternative	An ID that identifies the bill on client’s side.
remote_id (anyOf 2)	null	Alternative
vendor_contact_id	string	Optional	Unique identifier of vendor contact, must be associated with passed vendor. Format: uuid
vendor_id	string	Optional	Unique identifier of bill vendor. Format: uuid
vendor_memo	JSON	Optional
vendor_memo (anyOf 1)	string	Alternative	Memo to the vendor. Maximum length: 400
vendor_memo (anyOf 2)	null	Alternative

Referenced models: Create a bill — request body — body accounting field selections item, Update a bill — request body — body inventory line items array item, Update a bill — request body — body line items array item