API Updates — June 8, 2026

Purchase order owner assignment — You can now set the owner_id field when creating a purchase order to specify the owner, instead of defaulting to the API caller. View endpoint

Retainage withholding on purchase orders — Purchase orders now support retainage withholding via the new withholding_default_rate field on the purchase order and withholding_rate on individual line items. These fields are available when creating, updating, and reading purchase orders. View endpoint

Retainage withholding on bills — Bill line items now include withholding_line_item details (with gross_amount, withholding_amount, and withholding_percentage), and bills include an is_withholding_release field indicating whether a bill is a retainage release. View endpoint

Purchase order line item dates — Purchase order line items now include start_date and end_date fields indicating the spending window for each line item. View endpoint

Purchase order line item custom fields — Purchase order line items now return custom_field_values with the saved custom field selections for each line item. View endpoint

Receipt OCR tax data — Receipt OCR responses now include a taxes array with extracted tax_name, tax_rate, and tax_amount for each tax found on the receipt. View endpoint

New bills.updated webhook event — Subscribe to the bills.updated event type to receive notifications when bills are updated. View endpoint

Incorporation support for applications — Added needs_incorporation field to the create application request body, allowing you to indicate that a business still needs to be incorporated through Ramp's partner. When true, incorporation details (legal name, EIN, date and state of incorporation) must be omitted. View endpoint

Ramp checking account flag on applications — Application responses now include an open_ramp_checking_account field indicating whether the applicant is applying for a Ramp checking account. View endpoint

New audit log event types — Added Cash application agent action and Check PDF downloaded enum values for audit log event filtering. View endpoint

New GL account types — Added FIXED_ASSET_GAIN_ACCOUNT and FIXED_ASSET_LOSS_ACCOUNT enum values for accounting GL account configuration.

New OAuth scopes — Added budgets:read, incorporation:read, and incorporation:write OAuth scopes for budgets read access and incorporation lifecycle management.