title: Changelog source_url: /developer-api/v1/changelog summary: Stay up to date with our latest API updates via RSS feed (reader required). content: Stay up to date with our latest API updates via RSS feed (reader required). September 2, 2026 New AI usage endpoint (beta) — Retrieve daily AI usage and spend grouped by provider, model, and product with date-range filtering and cursor pagination. View endpoint New AI team spend endpoint (beta) — Retrieve estimated AI spend by Ramp user with provider, anomaly, and date-range filtering. View endpoint New AI API key spend endpoint (beta) — Retrieve API keys and their estimated spend with provider, status, and date-range filtering. View endpoint Vendor wire beneficiary addresses — Set the optional wire_details.beneficiary_address field when adding wire details to save the recipient's mailing address. If omitted, Ramp may copy the vendor's complete, valid default mailing address. View endpoint August 27, 2026 Vendor name updates — Set the optional name field when updating a vendor to change its display name. The value must contain at least one character. View endpoint August 21, 2026 New vendor contact creation endpoint — Create contacts for existing vendors with a required email and optional first_name, last_name, phone, and is_default fields. Responses indicate whether creation is approved or pending_approval. View endpoint August 20, 2026 Accounting field option lookup by ERP ID — Use the field_remote_id query parameter to list custom accounting field options using the field's ERP remote ID instead of its Ramp UUID. Provide exactly one of field_id or field_remote_id. View endpoint August 19, 2026 Purchase order bill filtering — Use the purchase_order_id query parameter to retrieve bills associated with a specific purchase order. View endpoint Vendor detail requestors — Set requesting_user_id when creating a vendor to choose the requestor recorded on payment or tax detail requests. The deprecated acting_user_id remains accepted but is ignored. View endpoint August 14, 2026 Merchant URL filtering — Use the merchant_url query parameter to filter merchants by a URL or domain. Values are normalized before matching stored merchant domains. View endpoint August 11, 2026 Merchant name prefix filtering — Use the case-sensitive merchant_name query parameter to filter merchants by display name prefix. View endpoint August 10, 2026 Submit draft bills (beta) — Submit an eligible draft bill with POST /developer/v1/bills/drafts/{draft_bill_id}/submit and receive the completed bill in the response. View endpoint Reimbursements ready to sync (alpha) — Alpha support adds REIMBURSEMENT as an object_type for the accounting ready-to-sync endpoint, allowing eligible reimbursements to enter the accounting sync workflow. View endpoint Application description length limit — The business.business_description field on financing applications now accepts up to 250 characters. View endpoint Bank debit trace IDs for bill payments — Bill payment responses now include bank_debit_trace_id with the bank-facing trace ID and descriptor when a bank debit leg is available. List endpoint Fetch endpoint Stable transaction split-line IDs — Transaction split line items now include a nullable id so integrations can reliably identify and reconcile persisted coding lines. List endpoint Fetch endpoint August 3, 2026 Currency-aware transaction amounts — Transaction responses now include entity_amount for the signed settlement amount and merchant_amount for the signed original charge, each expressed in minor units with an explicit ISO 4217 currency code. List endpoint Fetch endpoint Currency-aware initial credit limit — The business response now includes initial_approved_limit_amount in minor units with an explicit USD currency code, or null when no initial limit is approved. View endpoint Currency-aware trip totals — Trip responses now include total_spend_amount as a signed value in minor units with an explicit ISO 4217 currency code. It is null for trips without spend or with mixed or unrecognized currencies. List endpoint Fetch endpoint July 30, 2026 Default entity support for vendors — Set default_entity_id when creating or updating a vendor to associate it with a business entity. Set it to null when updating a vendor to clear the association. Create endpoint Update endpoint Vendor approval status — Vendor details now include approval_status with an APPROVED, PENDING, or REJECTED value. View endpoint Request vendor payment and tax details — Set request_payment_details or request_tax_details when updating a vendor to request missing onboarding information from its default contact. View endpoint July 27, 2026 Decimal lot quantities for item receipts — Item receipt inventory_assignments now use the decimal-capable quantity field instead of unit_quantity, preserving fractional lot quantities without truncation. Create, list, and fetch responses also return each assignment's id, lot_number, quantity, and expiration_date. Create endpoint List endpoint Fetch endpoint Parent vendor association — Set parent_vendor_id when creating a vendor to associate it with an existing parent vendor. View endpoint July 24, 2026 Lot-level item receipt tracking — Add inventory_assignments to item receipt line items with a required lot_number and unit_quantity, plus an optional expiration_date, when receiving lot-tracked inventory. Assignment quantities must sum to the line item's unit_quantity. View endpoint July 23, 2026 Currency-aware transaction decline amounts — Transaction responses now include decline_details.declined_amount with a signed value in minor units and currency in ISO 4217 format, providing a currency-aware companion to the deprecated bare decline_details.amount. The new field may be null when no valid settlement currency is recorded. View endpoint View endpoint July 21, 2026 New crypto wallet bill payment method — Added CRYPTO_WALLET_TRANSFER as an explicit bill payment method so you can create stablecoin wallet payments directly instead of relying on the default payment method. View endpoint Attach crypto wallets to vendors — The vendor bank account update endpoint now accepts a crypto_details option (with wallet_address, network, and optional account_name) to attach a stablecoin wallet as a payout destination. Supported networks include ETHEREUM_MAINNET, BASE_MAINNET, ARBITRUM_MAINNET, POLYGON_MAINNET, SOLANA_MAINNET, and more. The payment_method_type field now includes a crypto value. View endpoint Vendor bank account last four digits — Vendor bank account responses now include account_number_last_four, letting you identify saved accounts without exposing the full account number. View endpoint New audit log event types — Added event types including Change applied, Change became stale, Change rejected, Change submitted for review, Dormant funds automation changed, Meta-approvals turned on, and Meta-approvals turned off. View endpoint New CUSTOMER accounting field option type — Added CUSTOMER as an enum value for accounting field option object types. Purchase order autocoding suggestions — OCR-based purchase order drafts now return purchase_order_autocoding_suggestions, providing suggested tracking category values for both body fields and individual line items. View endpoint Renewal brief on unified requests — Unified request agreement details now include a renewal_brief field with the renewal brief document_id and title when available. View endpoint July 16, 2026 Fetch bill remittance receipts — Retrieve a bill's remittance receipt as a PDF via GET /developer/v1/bills/{bill_id}/remittance-receipt. View endpoint Unscoped client credentials tokens — The scope field is now optional for grant_type=client_credentials requests. If omitted, the returned token has no scopes instead of returning a validation error. View endpoint New currency option — Added the USDSUI enum value to currency fields across bills, entities, and other resources. Clearer default Bill Pay account mapping — The default_bill_pay_payment_account_id field on entities now documents that its bank account UUID can be matched against payment_accounts[].id and accounts[].bank_account_id. View endpoint July 15, 2026 Bill hold and release endpoints (beta) — Block or resume scheduled payments on a bill via POST /developer/v1/bills/{bill_id}/hold (with an optional reason) and POST /developer/v1/bills/{bill_id}/release. View endpoint View endpoint Vendor hold and release endpoints (beta) — Block or resume payments to a vendor via POST /developer/v1/vendors/{vendor_id}/hold (with an optional reason) and POST /developer/v1/vendors/{vendor_id}/release. View endpoint View endpoint Default Bill Pay payment account on entities — Accounting connection responses now include default_bill_pay_payment_account_id, and each account now returns a bank_account_id so you can match the entity's configured default Bill Pay account to its GL account. View endpoint GL account visibility support — General ledger account responses now include a visibility field, and you can set VISIBLE or HIDDEN when updating an account via PATCH /developer/v1/accounting/accounts/{gl_account_id}. View endpoint Audit log time filter aliases — The audit log events endpoint now accepts start_time and end_time as compatibility aliases for from_date and to_date. View endpoint New FedNow payment method — Added FED_NOW enum value for instant FedNow bank transfers across bill and payment schemas. Reimbursement ID on receipts — Receipt responses now include a reimbursement_id field identifying the reimbursement a receipt belongs to. View endpoint Negative tax rates supported — Removed the non-negative constraint on the tax rate field for create, update, and response schemas, enabling reverse-charge rates. View endpoint Expanded business entity types — Application requests now accept COOPERATIVE, CORPORATION, LLC, NON_PROFIT_CORPORATION, OTHER, PARTNERSHIP, and SOLE_PROPRIETORSHIP for entity_type. View endpoint New agreement renewal status — Added PLANNING enum value for vendor agreement renewal status, used to track draft renewals separately from submitted requests. View endpoint New bill pay audit log event — Added the Bill pay marked as unpaid event action to audit log events. View endpoint New iCalendar file type support — Added ics (text/calendar) as a supported file type for documents and attachments. New GL account usage types — Added FIXED_ASSET_ACCUMULATED_IMPAIRMENT_ACCOUNT, FIXED_ASSET_IMPAIRMENT_LOSS_ACCOUNT, and FIXED_ASSET_PROCEEDS_ON_DISPOSAL_ACCOUNT enum values to GL account responses. View endpoint Retainage withholding rate on purchase order line items — Purchase order line items now return a withholding_rate field for retainage-aware workflows. View endpoint OCR-detected currency on spend requests — Spend request OCR responses now include an ocr_detected_currency field showing the raw currency value detected when a fallback occurred. July 6, 2026 New audit log event type — Added Fraud Omni investigation started as a new event type for filtering audit log events, triggered when a fraud investigation is started for a Zendesk ticket. View endpoint Application entity type restricted to LLC — The entity_type field on application creation now only accepts LLC as a valid value. Previously accepted values like CORPORATION, PARTNERSHIP, and others are no longer accepted in requests, though existing applications with those values may still return them in responses. View endpoint New api channel for lead referral partners — Added api as a new enum value for the lead_referral_partner_channel field when creating applications, indicating the partner code was supplied through the Ramp API. View endpoint July 2, 2026 New updated_at field on transactions — Transaction responses now include an updated_at timestamp representing the latest of user transaction time, settlement time, and interaction state update time. This makes it easier to understand exactly when a transaction was last modified, complementing the existing updated_after query filter. View endpoint Vendor memo support for draft bills — You can now include a vendor_memo field (up to 400 characters) when creating or updating draft bills via POST /developer/v1/bills/drafts and PATCH /developer/v1/bills/drafts/{draft_bill_id}. The memo is also returned in bill responses. View endpoint Target payment arrival date for bills — Added target_payment_arrival_date field when creating bills with use_default_payment_method=true. Ramp uses this date to compute the latest payment initiation date needed to target vendor arrival, automatically adjusting if the computed date falls on a weekend, holiday, or past cutoff. View endpoint Ownership acknowledgement for financing applications — The create application endpoint now accepts an ownership_acknowledgement field with values CONFIRM_ALL_MAJOR_OWNERS_ENTERED or CONFIRM_NO_INDIVIDUAL_OWNS_25_PCT, letting you confirm beneficial ownership status during application creation. View endpoint Lead referral partner attribution for applications — New optional lead_referral_partner_code and lead_referral_partner_channel fields on application creation allow agent-reported partner attribution with supported codes like yc, clerky, cofounder_co, and others. View endpoint Retainage details on purchase order line items — Purchase order line items now include a withholding_line_item object with gross_amount, withholding_amount, and withholding_percentage fields for tracking retainage withholding. View endpoint New audit log event type — Added Bill pay accrual synced to the list of supported audit log event types for tracking when bill accruals are synced. View endpoint Currency enum values on transaction amounts — The currency field on transaction amount objects now returns a well-defined enum of ISO 4217 currency codes (plus stablecoin codes like USDC, USDT, EURC), giving you a complete set of possible values for validation and display. June 29, 2026 New AI usage ingestion endpoint — Added POST /developer/v1/ai-usage/unified for broadcasting provider-neutral AI usage event batches to Ramp AI spend analytics. View guide Ownership percentage for beneficial owners — Added ownership_percentage field to the controlling officer and beneficial owner schemas when creating or updating applications, allowing you to specify each individual's beneficial ownership percentage (integer, 0–100). View endpoint Bank account subtype in responses — Bank account objects now include an account_subtype field, providing visibility into whether an account is checking, savings, or another subtype. View endpoint New bank_accounts:write OAuth scope — A new bank_accounts:write scope is available for OAuth token requests, enabling write access to bank accounts for manual ACH account creation workflows. View endpoint Approver groups in custom records native tables — Added approver_groups as a supported native table reference across custom records endpoints, allowing you to reference approver groups in native table columns and result columns alongside users and accounting_field_options. New purchase order fund creation error — Added punchout_order enum value to purchase order fund creation error reasons, indicating that funds cannot be issued for punchout purchase orders. View endpoint June 25, 2026 Original transaction ID for refunds — Transaction responses now include an original_transaction_id field that links refund transactions back to their original transaction. View endpoint Application type selection — The POST /developer/v1/applications endpoint now accepts an application_type field with values BILL_PAY_ONLY or RAMP_SUITE (default), letting you specify whether the business is applying for bill pay only or the full Ramp Suite. The field is also returned on application reads. View endpoint Manual bank account on application creation — You can now provide manual_bank_account details (account number, routing number, account subtype, and balance) when creating an application via POST /developer/v1/applications, enabling bank account setup without external linking. View endpoint Incorporation status on application reads — Application responses now include incorporation_status (with values FORMED, INCORPORATED_EXTERNALLY, INCORPORATING, NOT_INCORPORATED) and needs_incorporation, so you can track whether a business still needs to complete incorporation through Ramp. View endpoint Vendor bank account update response — The POST /developer/v1/vendors/{vendor_id}/update-bank-accounts endpoint now returns a structured response body with vendor_id, payment_method_id, payment_method_type (ach or wire), status (approved or pending_approval), and proposal_id, giving you visibility into whether the update was applied immediately or requires approval. View endpoint New audit log event types — Added several new event types for audit logs: Bill pay submission policy updated, Compliance flag updated, Edited spend allocation request, Flex fee redeemed, Manual redemption redeemed, New vendor approval policy updated, Submission policy updated, and Vendor edit approval policy updated. View endpoint Removed transactions.all_requirements_met_and_approved webhook event — The deprecated webhook event type transactions.all_requirements_met_and_approved has been removed. Use transactions.all_requirements_met_and_approved_changed instead. View endpoint New GL account classification — Added AR_SALES_TAX_PAYABLE_ACCOUNT to the accounting entity GL account classification enum for tracking AR sales tax collected for remittance. View endpoint June 22, 2026 New physical card endpoints (beta) — List, fetch, create, update, terminate, suspend, and unsuspend physical cards via dedicated endpoints under /developer/v1/cards/physical. These new endpoints use fund_id instead of the legacy spend_limit_id and return detailed physical card resources including fulfillment and shipping information. View endpoint New virtual card endpoints (beta) — List and fetch virtual cards via GET /developer/v1/cards/virtual and GET /developer/v1/cards/virtual/{card_id}, returning a streamlined virtual card resource with fund_id, user_id, and suspension status. View endpoint New card vault endpoints (beta) — Create a fund and retrieve sensitive card details via POST /developer/v1/cards/vault, and fetch sensitive card details via GET /developer/v1/cards/vault/{card_id}. View endpoint Multiple vendor addresses — Vendor responses now include an addresses array containing all vendor addresses with id and is_default fields. The existing address field continues to return the default address. View endpoint Improved vendor state field documentation — The vendor state field now clearly specifies it expects a two-letter US state abbreviation (e.g., VA) when the vendor country is US. This applies to both vendor-level and address-level state fields. View endpoint Filter rules for inactive accounting connections — Added optional accounting_connection_id query parameter to GET /developer/v1/accounting/field-option-filter-rules and request body field to the create and delete endpoints, enabling you to manage filter rules belonging to inactive accounting connections. View endpoint PKCE support for OAuth application handoff — Added optional code_challenge field to the application OAuth authorize params, enabling PKCE (S256) security during the authorization flow. View endpoint New webhook event types — Added transactions.all_requirements_met_and_approved_changed, which fires when a transaction's approval and requirements status changes, while keeping transactions.all_requirements_met_and_approved as a deprecated alias. Also added transactions.body_coding_updated, which fires when a transaction's body-level accounting coding is created or changed. View endpoint New audit log event types — Added Accounting fixed asset changed, Accounting fixed asset class changed, Approval policy set as default, and Synced draft policy from workflow event types for audit log filtering. View endpoint New audit log entity types — Added Fixed asset and Fixed asset class as filterable entity types in the audit logs endpoint. View endpoint Tracking category is_erp_sourced field — Tracking category responses now include an is_erp_sourced boolean indicating whether the tracking category exists in the connected ERP system. Purchase order total in business currency — Purchase order line item details now include total_amount_details_in_business_default_currency for the amount converted to the business's default currency. .xlsm file support — Macro-enabled Excel files (.xlsm / application/vnd.ms-excel.sheet.macroEnabled.12) are now accepted for receipt and document uploads. Card state descriptions — The card state enum now includes descriptions for each value: ACTIVE, CHIP_LOCKED, SUSPENDED, TERMINATED, and UNACTIVATED. June 11, 2026 New all_requirements_met_and_approved field on transactions — Transaction responses now include an all_requirements_met_and_approved boolean indicating whether the transaction is fully approved and all cardholder requirements (receipts, memos, tracking categories) are met. View endpoint New webhook event types for transactions — Added transactions.all_requirements_met_and_approved (fires when a transaction is fully approved with all required items completed) and transactions.receipt_added to the list of subscribable webhook events. View endpoint New fund_id field on bill card payment details — Bill responses now include fund_id in card payment details, which identifies the fund associated with the payment. The existing spend_limit_id field continues to be returned but is now marked as deprecated. View endpoint Acting on behalf of another user when creating vendors — Added optional acting_user_id field to POST /developer/v1/vendors to specify which Ramp user is recorded as the requestor. This user is used for approval policy evaluation. Requires admin or owner privileges on the OAuth token. Defaults to the token owner when omitted. View endpoint Include draft vendors when listing — Added include_draft query parameter to GET /developer/v1/vendors. When set to true, the response includes vendors that are still in draft state or pending creation approval — useful for deduplicating by external_vendor_id immediately after creating a vendor on businesses with vendor approval policies enabled. Defaults to false. View endpoint New banking endpoints (beta) — List all banking accounts for your business via GET /developer/v1/banking/accounts and retrieve daily balance history for a specific account via GET /developer/v1/banking/accounts/{account_id}/balance-history. These replace the previous /developer/v1/treasury/ paths. View endpoint List syncable banking transactions — Retrieve banking transactions available for syncing to an accounting provider via GET /developer/v1/banking/syncable-transactions, with filtering by entity_ids, start_date, end_date, and include_synced_transfers. View endpoint New Ticket approvers updated audit log event type — Added Ticket approvers updated to the list of audit log event types, fired when a ticket's approvers are changed. View endpoint Memo field max length constraint removed — The memo field on transaction responses no longer advertises a maxLength of 255, reflecting that memos may exceed that length. June 9, 2026 New fund_id field on transactions — Transaction responses now include a fund_id field that returns the unique identifier of the fund associated with the transaction. The existing limit_id field is deprecated and returns the same value as fund_id. View endpoint New fund_id field on reimbursements — Reimbursement responses now include a fund_id field identifying the fund to which the reimbursement is attributed. The existing spend_limit_id field is deprecated and returns the same value as fund_id. View endpoint New display_name field on accounting field options — Accounting field option objects across transactions, bills, reimbursements, vendor credits, and purchase orders now include a display_name field. When a customer renames an option inside Ramp, display_name returns the Ramp-side label while name continues to return the original ERP-sourced name. Returns null if no override is set. View endpoint Bank account connection provider filtering — Added the connection_provider query parameter to the List Bank Accounts endpoint, letting you filter by how the account was connected (e.g., plaid, manual, finicity, teller, ramp_wallet, ramp_brokerage). View endpoint New connection_provider field on bank accounts — Bank account responses now include a connection_provider field indicating the provider used to connect the account (e.g., plaid, manual, teller). View endpoint 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. June 1, 2026 New treasury accounts endpoint (beta) — List all treasury accounts for your business, including wallet, brokerage, and managed portfolio accounts. Filter results with start and page_size pagination parameters. View endpoint New treasury balance history endpoint (beta) — Retrieve daily available balance snapshots for a specific treasury account, with optional start_date and end_date filtering in ISO 8601 format. View endpoint Upload accounting entities (beta) — New endpoint to upload up to 500 ERP subsidiaries/entities in a single request, enabling entity-level scoping for accounting fields, vendors, GL accounts, and more. View endpoint Entity selection setting for accounting connections — Added entity_selection_enabled to accounting connection settings, available when creating (POST) or updating (PATCH) a connection. This controls whether ERP entity selection is active for API-based accounting connections. View endpoint Entity scoping for GL accounts — Added entity_remote_ids field to create, update, and list GL account endpoints, letting you scope GL accounts to specific ERP entities. View endpoint Entity scoping for accounting vendors — Added entity_remote_ids field to create, update, and list accounting vendor endpoints, so vendors can be restricted to specific ERP entities. View endpoint Entity scoping for tax code options — Added entity_remote_ids field to create, update, and list tax code option endpoints, allowing tax codes to be scoped to specific ERP entities. View endpoint Custom record fields on entities — Added include_custom_field_values query parameter to GET /developer/v1/entities and GET /developer/v1/entities/{entity_id}. When set to true, the response includes a custom_record_fields array with custom field values for each entity. View endpoint Purchase order line item custom fields — The purchase order detail response now includes custom_field_values on each line item, returning saved custom field data. View endpoint Spend program line item custom fields — The spend program detail response now includes a line_item_custom_fields array, showing each enabled custom field's ID, display name, type, description, and whether it's required. View endpoint New accounting field selection source — Added AI_AUTOCODING enum value to the source field on accounting field selections, indicating a selection was assigned by AI purchase order autocoding. New audit log event type — Added Status updated by intake agent event type for tracking when an accounts receivable customer status is updated by the intake agent. View endpoint May 28, 2026 Parent vendor ID on vendor responses — Vendor endpoints now include a parent_vendor_id field, making it easy to identify vendor parent-child relationships directly from the API. View endpoint Network merchant ID on transactions — Transaction responses now include a network_merchant_id field containing the card acceptor merchant identifier from the payment network (e.g., Visa), or null when unavailable. View endpoint Entity scoping for accounting field options — The entity_remote_ids field is now returned on GET /developer/v1/accounting/field-options responses and accepted on POST and PATCH requests, letting you scope field options to specific business entities. View endpoint Entity scoping for inventory item options — Inventory item option endpoints now support entity_remote_ids on POST, PATCH, and GET operations, enabling per-entity availability control for inventory items. View endpoint Child vendors endpoint — List child vendors of a parent vendor via GET /developer/v1/vendors/{vendor_id}/children. View endpoint Funds API (beta) — A full suite of endpoints for managing funds, including creating, listing, updating, terminating, suspending/unsuspending funds, and managing fund members. Funds can be linked to spend programs or configured standalone with spending restrictions, permitted spend types, and accounting rules. View endpoint Field option filter rules (beta) — New endpoints to bulk create, list, and bulk delete field option filter rules, which define conditional visibility of accounting field options based on selections in other fields. View endpoint ERP migration readiness endpoint — Mark an inactive API-based accounting connection as ready to migrate via POST /developer/v1/accounting/connection/{connection_id}/ready-to-migrate, enabling the ERP migration flow UI for your customers. View endpoint Transaction update endpoint (beta) — Update transactions via PATCH /developer/v1/transactions/{transaction_id} to create, replace, or remove line item splits with accounting field selections and memos. View endpoint Treasury syncable transactions endpoint — List treasury transactions available for syncing to an accounting provider via GET /developer/v1/treasury/syncable-transactions, with filtering by date range, entity, and sync status. View endpoint New audit log event types — Added Internal impersonation upgraded to read-write, Preview mode entered, Spend settings updated, Vendor parent set, and Vendor parent unset to the audit logs event_type enum. View endpoint Sync status enum descriptions — The sync_status filter parameter on transactions, reimbursements, transfers, and cashbacks now includes descriptions for NOT_SYNC_READY, SYNCED, and SYNC_READY values. May 21, 2026 Receipt OCR data now available — You can retrieve structured OCR data (currency code and line items with name, date, quantity, unit price, and total price) from receipts by passing the include_ocr_data query parameter on the List Receipts and Get Receipt endpoints. View endpoint Entity scoping for accounting field options — When creating field options via POST /developer/v1/accounting/field-options, you can now pass entity_remote_ids to restrict an option to specific entities. When updating via PATCH /developer/v1/accounting/field-options/{field_option_id}, you can set, reset (with null), or leave entity scoping unchanged. View endpoint Fund filtering by member role — The member_roles query parameter on GET /developer/v1/funds accepts OWNER, COOWNER, and MEMBER values. Use this with user_id to filter funds by a user's access role. View endpoint GOVERNMENT_ENTITY removed from application entity types — The GOVERNMENT_ENTITY enum value is no longer accepted for the entity_type field when creating applications via POST /developer/v1/applications. Requests using this value will now fail validation. View endpoint Currency code renamed from OUSD to OPEN_USD — The currency enum value OUSD has been renamed to OPEN_USD across all endpoints that accept or return currency codes. Renamed "Business Account" to "Checking Account" — Default account_name values in vendor ACH and wire bank account request bodies now default to Checking Account instead of Business Account. The audit log event Business Account terms accepted has been renamed to Checking Account terms accepted. New audit log event types — Added Bill pay rejected PDR bank account ownership match, External agent key created, External agent key revoked, External agent key updated, and Initiated digital wallet provisioning (audit) as filterable event types. The previous Agent key created, Agent key revoked, and Agent key updated values have been replaced by their External agent key counterparts. View endpoint New spend request action and denial reasons — Purchase order spend requests now include a send_pdf_to_vendor available action, and the agreement linking denial reasons include a new punchout_order value indicating agreements are not supported for punchout purchase orders. Punchout order ID on purchase order line items — Purchase order line item responses now include a punchout_order_id field. May 19, 2026 New accounting codings endpoint (beta) — Post accounting coding selections to Ramp objects like transactions via POST /developer/v1/accounting/codings. Specify an object_id, object_type (currently TRANSACTION), and an array of accounting_coding_selections with field and option IDs. View endpoint Purchase order edit_line_items action detail — The purchase order permitted_actions response now includes an edit_line_items field indicating whether line items can be edited, with denial reasons such as archived, no_permission, and punchout_order. New purchase order denial reason values — Several purchase order action denial reason enums now include additional values: archived added to IssuePurchaseOrderFundDenialReason, AgreementCreationPostApprovalDenialReason, and UploadBillDenialReason; punchout_order added to RequestAgainDenialReason and RequestChangesDenialReason. Clarified fund and card display name descriptions — A fund's display_name is separate from each linked card's display_name. The display_name query parameter on the List Funds endpoint filters by the fund's display name. View endpoint May 18, 2026 New audit log actor type — Added spend_request_agent as a new actor_type enum value for filtering and identifying Spend Request Agent activity in audit log events. View endpoint New audit log event types — Added several new event types for audit logs including Accounting settings updated, Agent key created, Agent key revoked, Agent key updated, Bank account ACH details viewed, Bank account sensitive details viewed, Identity locked, Identity unlocked, Transfer created, and WBX request admin approved entire workflow. View endpoint New transaction decline reason — Added AUTHORIZER_UNDER_TRANSACTION_AMOUNT_LIMIT enum value indicating a transaction amount fell below the per-transaction minimum. Clarified location entity update side effect — The entity_id field description on PATCH /developer/v1/locations/{location_id} now clarifies that updating a location's entity also moves existing users assigned to that location to the updated entity. View endpoint Vendor accounting link uniqueness documented — The accounting_vendor_remote_id and vendor_tracking_category_option_id fields on POST /developer/v1/vendors now clarify that the referenced accounting vendor must not already be linked to another Ramp vendor. View endpoint New OUSD currency code — Added OUSD to supported currency code enums across bill and transaction schemas. New tasks:read OAuth scope — Added tasks:read scope for granting read access to tasks. New ARAVO third-party risk management provider — Added ARAVO as a new enum value for ThirdPartyRiskManagementProviderType. Date-time support for custom record values — Custom record row values now accept date-time formatted strings in addition to numbers, strings, booleans, and arrays. New PAYEE document version type — Added PAYEE as a new enum value for RampDocumentVersionType. New edit_accounting_merchant vendor action — Vendor response now includes an edit_accounting_merchant action detail indicating whether the caller can edit the vendor's accounting merchant link, with denial reasons such as archived, matches_payee_vendor, no_payee, and no_permission. New allow_none field on tracking category settings — The TrackingCategorySettings schema now includes an allow_none boolean field. May 11, 2026 Bill payment date scheduling — You can now set an optional payment_date field when creating or updating bills via POST /developer/v1/bills and PATCH /developer/v1/bills/{bill_id} to schedule when a non-card payment should be initiated. Send null on update to unschedule a previously set payment date. View endpoint May 8, 2026 New audit log event types — Added several new event types for the audit logs endpoint: Cash manager recommendation reviewed, Forecast custom input deleted, Forecast custom input updated, Forecast settings updated, and Strict MFA setting updated. View endpoint Schedule bill payments via API — You can now set an optional payment_date field when creating or updating bills to schedule when a non-card payment should be initiated. Pass null to clear a previously scheduled date. View endpoint Update GL account on inventory item options — The PATCH /developer/v1/accounting/inventory-item/options/{option_id} endpoint now accepts an optional gl_account_id field, letting you associate an inventory item option with a specific GL account. View endpoint Spending restrictions on unified requests — Unified request responses now include a spending_restrictions object with an interval field, so you can see the spend frequency associated with a request. View endpoint New allowed_overage_percent field on unified requests — Unified request responses now include allowed_overage_percent, indicating the permitted overage percentage for a spend allocation request. View endpoint May 6, 2026 New Comments endpoints (beta) — List and create comments on bills and spend requests via GET /developer/v1/comments/{object_type}/{object_id} and POST /developer/v1/comments/{object_type}/{object_id}. Supports bills and spend-requests as object_type values, with paginated responses. View endpoint Purchase order deep links — Purchase order responses now include a ramp_url field with a stable permalink to the purchase order in the Ramp web application. View endpoint Unified request deep links — Unified request responses now include a ramp_url field linking directly to the request in the Ramp web application. View endpoint Bill update line item PO matching — When updating bills, line_items and inventory_line_items now accept a purchase_order_line_item_id field to match individual line items to specific purchase order line items. View endpoint GL account association for inventory item options — The PATCH /developer/v1/accounting/inventory-item/options/{option_id} endpoint now accepts a gl_account_id field to associate an inventory item option with a GL account. View endpoint Mileage reimbursement fund attribution — The POST /developer/v1/reimbursements/mileage endpoint now accepts a spend_allocation_id field to attribute a mileage reimbursement to a specific fund. View endpoint Multi-currency spending restriction support — Spending restriction descriptions for limit and transaction_amount_limit on cards and spend limits now correctly reference the smallest currency unit rather than assuming USD cents, reflecting proper non-USD currency handling. Mock webhook business_id field — The mock webhook event response now includes a business_id field identifying the business associated with the event. View endpoint New webhook event types — Added entities.created and transactions.synced as new webhook event types you can subscribe to and trigger via mock webhooks. View endpoint Matrix table append duplicate handling — The append rows endpoint for matrix tables now supports an ignore_duplicates boolean parameter. Set it to true to skip existing duplicate cells instead of returning an error. View endpoint Expanded audit log event types — Added 30+ new event_type enum values for audit logs, including Account details viewed, Passkey created, Passkey deleted, Transfer initiated, User logged out, Voided check downloaded, Payment run action, Edited custom field, Cash Manager settings updated, and more. View endpoint New audit log resource types — Added Cash Manager recommendation, Forecast custom input, Payment run, and Wallet automation policy as resource_type enum values for audit log events. View endpoint April 30, 2026 Card expiration in Vault API response — GET /developer/v1/cards/vault/{card_id} returns an expiration field with the card's expiration date in MMYY format, aligning the GET response with the existing POST response. View endpoint Update purchase order memo — You can now set, update, or clear the memo field when calling PATCH /developer/v1/purchase-orders/{purchase_order_id}. View endpoint Spend program workflow nodes simplified — The kind field has been removed from the workflow nodes response on GET /developer/v1/spend-programs/{spend_program_id}/workflow-nodes. This field was never populated in actual responses; the schema now matches the real response shape. View endpoint New audit log event types — Added several new event_type values for audit log filtering: Account closed, Account renamed, Bank letter downloaded, Investment Account closed, Investment Account opened, Vendor hold released, Vendor placed on hold, and WBX request archived. View endpoint New audit log resource types — The resource_type filter now includes Investment account and Managed portfolio transfer (replacing the previous Brokerage account value). View endpoint New vendor document categories — Added ADDENDUM_OR_RIDER, AMENDMENT, CONTRACT_OTHER, ENGAGEMENT_LETTER, SECURITY_EXHIBIT, and SLA to the document_category enum for vendor agreement document uploads. View endpoint April 28, 2026 Purchase order memo updates — You can now update the memo field when patching a purchase order via PATCH /developer/v1/purchase-orders/{purchase_order_id}. View endpoint Longer invoice numbers on bills — The invoice_number field on bills now supports up to 84 characters (previously 20), accommodating longer invoice numbers from certain accounting providers. View endpoint GL account linking for inventory item options — Inventory item options now include a gl_account_id field, letting you associate a GL account when creating or viewing inventory item options. View endpoint New vendors.updated webhook event — Subscribe to the vendors.updated event to get notified when vendor details change. View endpoint New TRANSFER_LEDGER_ENTRY_MAPPING sync type — Added TRANSFER_LEDGER_ENTRY_MAPPING as a supported entity type for accounting syncs, enabling sync support for transfer ledger entry mappings. View endpoint New is_not_null query clause for custom records — Matrix table row queries now support an is_not_null clause type, letting you filter for rows where a column value is not null. View endpoint New audit log event types — Added Account opened as a new audit log event type and Treasury account / Wallet transfer as entity types for more granular audit trail filtering. View endpoint New supported file types — Added jsonl and npy to the list of accepted file formats for uploads. April 27, 2026 New Ramp-only accounting fields endpoints (beta) — Manage custom accounting fields that exist only in Ramp (not synced from an ERP). Create, list, fetch, update, and delete Ramp-only fields and their options. View endpoint New user invite management endpoint (beta) — Control the invite lifecycle for draft users with POST /developer/v1/users/{user_id}/invite. Schedule an invitation for a future time (SCHEDULE), cancel a scheduled invitation (DESCHEDULE), or send the invite immediately (SEND_NOW). View endpoint Draft user creation support — Added is_draft field to the create user request body. When set to true, the user is created in a DRAFT state without sending an invite email, allowing you to activate them later. View endpoint User lifecycle status field — User responses now include a lifecycle_status field with possible values DRAFT, PENDING, ACTIVE, INACTIVE, and DELETED, giving you visibility into where a user is in their lifecycle. Vendor agreement link and unlink endpoints (beta) — Link purchase orders or documents to a vendor agreement via POST /developer/v1/vendors/agreements/{agreement_id}/link, link spend requests via POST /developer/v1/vendors/agreements/{agreement_id}/link-spend-request, and unlink them via DELETE /developer/v1/vendors/agreements/{agreement_id}/unlink. View endpoint Filter bills by missing payment details — Added payment_details_missing query parameter to the list bills endpoint. Set to true to return only bills that are missing vendor bank account or payment method information. View endpoint Enhanced vendor credit filtering — Added entity_id, from_created_at, and to_created_at query parameters to both vendor credits list endpoints for filtering by business entity and creation date ranges. View endpoint SPEND_PROGRAM added to accounting field locations — The remote_field_locations enum for accounting fields now includes SPEND_PROGRAM, enabling accounting field mapping on spend programs. GOVERNMENT_ENTITY vendor business type — Added GOVERNMENT_ENTITY as a new enum value for vendor business entity types when creating or updating vendors. Relaxed bill line item unit_price validation — The unit_price field on bill line items no longer enforces a minimum of 0, allowing negative unit prices for credit adjustments. Nullable manual_payment_method — The manual_payment_method field on bill payment details is now nullable, returning null when a bill has not yet been marked as paid. New audit log event types — Added numerous new event types for audit logs including Accounting coding rules updated, Bill linked to contract, Bill unlinked from contract, Cashback redeemed, Counterparty created, Counterparty details changed, International payment initiated, Large transfer initiated, Mass payout initiated, Payment approval overridden, Payment to new counterparty, and various WBX (workflow) and RFX (sourcing) events. View endpoint New audit log entity types — Added Brokerage account, WBX Policy, WBX Request, and Wallet account as entity types for audit log filtering. April 17, 2026 New blank canvas approvals endpoints — Approve or reject blank canvas workflow steps, update metadata for external approval requests, and upload documents for blank canvas workflow steps. View endpoint · View metadata endpoint · View documents endpoint New repayments endpoint — List repayments with filtering by entity, funding method, repayment date range, and user. View endpoint New unified requests endpoints — List and fetch unified spend requests with filtering by department, entity, location, owner, spend program, request type, status, amount range, and date range. View endpoint New spend request endpoints — Create draft spend requests via OCR, list and create comments on spend request discussion threads. View endpoint · View comments endpoint New spend program workflow nodes endpoint — Fetch blank canvas workflow nodes for a spend program, filtered by external approval service key. View endpoint New custom form collection response endpoint — Fetch a custom form collection response by ID. View endpoint New vendor agreement endpoints (beta) — Create, fetch, update, and delete vendor agreements, upload agreement documents, and create agreements for specific vendors. View endpoint · View documents endpoint New mock webhook event endpoint — Create mock webhook events for testing active subscriptions matching a given event type. View endpoint Audit log object filtering — Added object_id and resource_name query parameters to the audit logs endpoint for filtering events by specific object ID and resource type. View endpoint Purchase order external ID support — Added external_id field to purchase order and line item creation and responses, plus external_id and remote_id query parameters for filtering purchase orders. View endpoint Purchase order shipping fields — Purchase order responses now include ship_to_address, ship_to_company_name, shipping_contact_email, shipping_contact_first_name, shipping_contact_last_name, and shipping_contact_phone_number fields. New purchase order creation source — Added EXTERNAL_IMPORT enum value to the creation_source field on purchase orders. Accounting connection ID support across accounting endpoints — Added optional accounting_connection_id query parameter to GL accounts, custom fields, custom field options, inventory items, tax codes, tax rates, and accounting vendor endpoints for accessing resources belonging to inactive accounting connections. Enhanced vendor filtering — Added to_created_at, from_updated_at, and to_updated_at query parameters to the List Vendors endpoint for date-based filtering. View endpoint Draft user status support — Added USER_DRAFT enum value to the user status filter and response field, along with a new scheduled_invitation_date field on user responses. View endpoint Business balance structured amounts — The business balance response now includes CurrencyAmount fields (e.g., available_card_limit_amount, card_limit_amount, statement_balance_amount) with explicit currency codes and minor unit values alongside the existing numeric fields. View endpoint Bank account name field — Bank account responses now include an account_name field. View endpoint Reimbursement trace ID — Reimbursement detail responses now include a trace_id field with the bank-facing accountability reference for the payment. New limit state — Added ARCHIVED enum value to the limit state field. New currency support — Added USDT to supported currency codes across bill, purchase order, and other endpoints. New accounting field type — Added UNIT_OF_MEASURE to the remote_type enum for custom accounting fields. New webhook event types — Added bills.ready_to_sync, payments.updated, transactions.declined, and users.invite_accepted event types for webhook subscriptions. New audit log event types — Added numerous new audit log event types including ABK agent schedule failed, Accounting provider access changed, Bill pay AP coworker questions answered, Business bank account added/changed/removed, HRIS integration setting updated, Item receipt accounting sync, Reimbursement field changed, Trip changed, Vendor added to group, Vendor removed from group, and several RFX and question-related events. March 30, 2026 New List Bank Accounts endpoint — Retrieve a paginated list of bank accounts associated with your business. Supports start and page_size query parameters for pagination. View endpoint New List Vendor Agreements endpoint (beta) — Query vendor agreements with extensive filtering options including date ranges, renewal status, contract owners, departments, total value, and custom record filters via POST /developer/v1/vendors/agreements. View endpoint Enhanced vendor filtering by timestamps — Added to_created_at, from_updated_at, and to_updated_at query parameters to the List Vendors endpoint for filtering vendors by creation and update dates. View endpoint Vendor subsidiary data — Added include_subsidiary query parameter to the List Vendors endpoint. When set to true, vendor responses include a subsidiary field with ERP subsidiary identifiers. View endpoint Allowed overage percent override on spend allocations — The allowed_overage_percent_override field allows a fund-level override for the allowed overage percent, independent of the spend program or business default. Update custom accounting field options — New PUT /developer/v1/accounting/field-options/{field_option_id} endpoint to update existing custom accounting field options. View endpoint New audit log event types — Added Generated renewal brief for contract, Spend allocation change request approval policy updated, and Vendor Network updates enabled event types to the audit logs endpoint. Updated token prefix format — Access tokens are now prefixed with ramp_business_tok_, ramp_user_tok_, ramp_business_jwt_, or ramp_user_jwt_ instead of the previous ramp_tok_ prefix. Refresh tokens use ramp_business_tok_ or ramp_user_tok_. Custom records reference columns relaxed — The corresponding_column_name field on reference column configurations is no longer required and defaults to null. It will be auto-generated if not provided, simplifying forward-only reference column setup. Auto-match uploaded receipts without a transaction ID — The POST /receipts endpoint can now automatically match uploaded receipts to transactions without requiring a transaction_id. View endpoint March 25, 2026 New financing applications endpoints (beta) — Create and fetch financing applications programmatically. Submit applicant details, business information, controlling officers, beneficial owners, and financial details. View GET endpoint | View POST endpoint | View guide New ready-to-sync endpoint (beta) — Mark accounting objects as ready to sync by providing a list of object_ids and an object_type (currently supports TRANSACTION). View endpoint New applications.status_updated webhook event — Subscribe to applications.status_updated to receive notifications when a financing application's status changes. View endpoint New bill payment status ON_HOLD — Added ON_HOLD enum value to the bill payment_status filter and response, representing bills that have been placed on hold. View endpoint New cancelled trip status — The status filter on the List Trips endpoint now supports the cancelled enum value, and trip responses can include cancelled as a status. View endpoint New audit log event type — Added Vendor linked to vendor network to the list of supported audit log event types. View endpoint New GL account classification types — Added AR_CHARGEBACK_CLEARING_ACCOUNT and AR_REFUNDS_CLEARING_ACCOUNT classification enum values for accounting GL accounts. March 19, 2026 New bill filtering by payment ID — Added customer_friendly_payment_id query parameter to filter bills by their customer-friendly payment identifier, making it easy to find all bills belonging to the same payment or batch payment. The response also now includes customer_friendly_payment_id on bill payment objects. View endpoint New bill filtering by draft bill ID — Added draft_bill_id query parameter to the List Bills endpoint to filter by the originating draft bill. The bill response now also includes draft_bill_id to indicate which draft bill a bill was created from. View endpoint New bill and draft bill filtering by remote ID — Added remote_id query parameter to both the List Bills and List Draft Bills endpoints, allowing you to look up bills and drafts by their external system identifier. View endpoint | View draft bills endpoint Reactivate deleted inventory item options — Added reactivate field to the PATCH /developer/v1/accounting/inventory-item/options/{option_id} request body, bringing parity with custom field options by letting you restore soft-deleted inventory item options. View endpoint Vendor owner is now optional — The vendor_owner_id field is no longer required when creating a vendor via POST /developer/v1/vendors. Omitting it creates the vendor without an owner. View endpoint March 18, 2026 Decimal quantity support for bill line items — The unit_quantity field has been replaced with quantity, which now accepts decimal values (e.g., 2.25) instead of only integers. unit_quantity is still accepted for backwards compatibility. The unit_price field also now accepts decimal string or number formats. This applies when creating or updating line items on bills and draft bills. View endpoint New GL account classification types — Added six new enum values for GL account classifications: AR_ACCOUNTS_RECEIVABLE_ACCOUNT, AR_BAD_DEBT_ACCOUNT, AR_CARD_FEES_ACCOUNT, AR_CASH_ACCOUNT_DEFAULT, AR_INCOME_ACCOUNT_DEFAULT, and AR_UNDEPOSITED_FUNDS_ACCOUNT, enabling accounts receivable accounting integrations. March 17, 2026 Vendor memo support for bills — Added vendor_memo field to create and update bill endpoints, as well as draft bill endpoints, allowing you to set a memo to the vendor (up to 400 characters) on a bill. View endpoint | View endpoint | View endpoint | View endpoint Refresh token expiration info — The token endpoint response now includes a refresh_token_expires_in field indicating how long the refresh token is valid (in seconds), making it easier to manage token lifecycle for clients configured with a refresh token TTL. View endpoint March 16, 2026 New embedded cards endpoint (beta) — Generate an embed init token for a card to enable embedded card experiences in your application. Requires the embedded_cards:write scope and the card must be activated and active. View endpoint New audit log event type — Added RFX graded to the list of supported audit log event types, allowing you to track when an RFX has been graded. View endpoint Global library field ID on custom record columns — Custom record column responses now include a global_library_field_id field, letting you identify columns that are linked to global library fields. March 12, 2026 Visibility filter for accounting field options — Filter custom accounting field options by visibility (HIDDEN or VISIBLE) using the new visibility query parameter. View endpoint Bill filtering by ERP sync status — Filter bills by whether they are configured to sync to your ERP using the new is_accounting_sync_enabled query parameter. View endpoint Payment accounts on entities — The entity response now includes a payment_accounts array containing bank accounts eligible for bill payment, with details like account_name, account_number_last_four, currency, and id. View endpoint Custom record fields on vendors — Vendor responses now include a custom_record_fields array with column metadata, display values, and reference row details for custom record data associated with each vendor. View endpoint Policy agent exemption for funds — Fund responses include is_exempt_from_policy_agent, which you can update via PATCH. View endpoint Accounting vendor creation flag on transactions — Transaction responses now include requires_accounting_vendor_creation_to_sync, indicating whether your integration must create an accounting vendor before syncing the transaction. View endpoint New webhook event types for unified requests — Added unified_requests.created, unified_requests.modified, unified_requests.node_advanced, unified_requests.override_approved, and unified_requests.updated to the list of subscribable webhook events. View endpoint New transaction decline reasons — Added AUTHORIZER_SPEND_ALLOCATION_MEMBER_SUSPENDED and AUTHORIZER_UNAUTHORIZED_USER enum values for more granular transaction decline details. New custom records reference table types — Added contracts and purchase_order_line_items as valid native reference table types for custom record columns. New custom record text display type — Added numeric_id to the available display types for custom record text columns. New audit log event types — Added ABK agent blocked on user, ABK agent review requested, ABK agent started, Document labeled, Edited contract tracking setting, and Reimbursement bank account updated for more comprehensive audit trail coverage. View endpoint New spend program mapped field type — Added REQUEST_REASON as a mapped field option for spend program configurations. New vendor document types — Added INVOICE and VENDOR_CREDIT to the list of supported vendor document types. February 27, 2026 Filter bills by payment ID — Added payment_id query parameter to the List Bills endpoint, letting you retrieve all bills belonging to the same batch payment. View endpoint Payment ID on bill responses — Bill payment details now include an id field representing the unique payment identifier. Bills sharing the same payment ID belong to the same batch payment. Draft bill attachment uploads — Upload file attachments to existing draft bills via POST /developer/v1/bills/drafts/{draft_bill_id}/attachments, using multipart/form-data. View endpoint Bank account ID on transfers — Transfer responses now include a bank_account_id field containing the UUID of the bank account used for the transfer payment (or null for wire transfers). Use GET /developer/v1/bank-accounts/{bank_account_id} to look up account details. View endpoint Vendor creation on sync setting for accounting connections — Added transaction_accounting_vendor_creation_on_sync_enabled to accounting connection settings. When enabled, card transactions missing a mapped accounting vendor will require vendor creation before sync. Available on create and update endpoints. View endpoint New INVOICE sync resource type — Added INVOICE as a supported enum value for accounting sync resource types, expanding the types of records you can sync through accounting connections. New webhook event types — Added bills.archived and reimbursements.batch_payment_reimbursed to the list of supported webhook event types, so you can subscribe to notifications when bills are archived or batch reimbursement payments are processed. View endpoint Scheduled deactivation date for new users — Added scheduled_deactivation_date field to the create user request. For guest users, this automatically defaults to 6 months from the invite creation date unless explicitly set to null. View endpoint Date column type for custom records — Custom record tables now support a datetime column type with date display, allowing you to store and display date values in custom and matrix tables. Attachments on custom form fields — Custom form field responses now include an attachments array containing document metadata with download URLs, filenames, and version information. New transaction decline reason — Added AUTHORIZER_SPEND_ALLOCATION_ARCHIVED_FUNDS enum value to transaction decline reasons, indicating a transaction was declined because the associated funds are archived. New OAuth scope — Added comments:write scope for granting write access to comments. February 13, 2026 New status_summary field on bills — Bill responses now include a status_summary field that provides a more granular view of a bill's lifecycle stage, with values like PAYMENT_SCHEDULED, APPROVAL_PENDING, PAYMENT_PROCESSING, PAYMENT_COMPLETED, and more. This gives you richer insight into exactly where a bill stands beyond the existing OPEN/PAID status. View endpoint Enhanced bill filtering by status_summary — The status_summary query parameter on the List Bills endpoint now uses a refined set of enum values (removing draft-related statuses like DRAFT_MISSING_INFO, DRAFT_PARSING, DRAFT_QUEUED, and DRAFT_READY) to filter bills by their detailed status. View endpoint New NON_ERP accounting field type — Added NON_ERP as a new enum value for accounting field types, allowing you to distinguish fields that are not sourced from an ERP system. View endpoint February 12, 2026 Clarified currency amount representations for bills and purchase orders — Documentation for amount fields on bills and purchase order line items now specifies that values are represented in the lowest denomination of the currency (e.g., cents for USD), making it easier to correctly interpret amount and unit_price fields. Filter funds by card — Use the card_id query parameter on the List Funds endpoint to filter for funds linked to a specific card. View endpoint Draft bill remote_id field — The draft bill response now includes a remote_id field, providing the external ID that identifies the bill on the client's side. View endpoint Custom Records column display types — Number columns now support a display_type field with values currency, number, and percentage. Text columns now support a display_type field with values email, paragraph, phone, plain_text, and url, giving you more control over how column data is presented. February 11, 2026 New endpoint to fetch accounting connection by ID (beta) — Retrieve details for a specific accounting connection using its connection_id. View endpoint Renamed tax code options request field — The POST /developer/v1/accounting/tax/code/options endpoint now uses options instead of tax_codes as the request body field name for uploading tax code options. View endpoint New item_receipts.created webhook event — Subscribe to item_receipts.created events to get notified when new item receipts are created. View endpoint Transaction functional_currency_amount moved behind query parameter — The functional_currency_amount field is no longer returned by default on transactions. Specify it via a query parameter to include the entity's functional currency amount in the response. View endpoint February 10, 2026 New tax code options management (beta) — Upload, list, update, and delete tax code options for accounting connections with filtering by remote_id, is_active, and code. View endpoints Enhanced vendor filtering — Added merchant_id query parameter to the List Vendors endpoint for filtering by associated card merchants. View endpoint Draft bill creation and updates — Create and update draft bills with support for accounting fields, line items, and vendor details. View endpoint Bills now include item receipt associations — Added item_receipt_ids field to bill responses showing linked item receipts from matched purchase orders. Accounting connection migration status — Added is_ready_to_migrate field to accounting connections indicating readiness for ERP migration workflows. February 5, 2026 New inventory item accounting field endpoints (beta) — Create, read, update, and delete inventory item accounting fields for tracking inventory items in your ERP system. View field endpoint Inventory item options management (beta) — Upload, list, update, and delete inventory item options with filtering by remote_id, is_active, code, and is_synced. View options endpoint New tax code accounting field endpoints (beta) — Create, read, update, and delete tax code accounting fields for managing tax codes in your ERP system. View endpoint Transaction sync button setting — Added transaction_sync_button_enabled setting to accounting connections for enabling manual transaction sync functionality in API-based integrations. Extended accounting field requirements — Added VENDOR_CREDIT enum value to is_required_for arrays in accounting fields, allowing fields to be required for vendor credit objects. New vendor awarded audit event — Added Vendor awarded event type to audit logs for tracking vendor award actions. February 3, 2026 Enhanced transaction data — Added functional_currency_amount field to transaction responses, showing the transaction amount in your entity's functional currency when an ERP with functional currency is configured. View endpoint Tax rate field renamed — The gl_account_id field in tax rate resources has been renamed to accounting_gl_account_id for better clarity across accounting tax rate endpoints. View endpoint January 30, 2026 New tax rates endpoints (beta) — List, upload, update, and delete tax rates for accounting integrations with support for up to 500 tax rates per batch upload. View list endpoint and View upload endpoint Enhanced bill creation — Added use_default_vendor_contact parameter to automatically use the vendor's default contact when creating bills, making vendor_contact_id optional. View endpoint Ramp category code enums — Category fields now include explicit enum values and descriptions for all Ramp category codes (1-44) across transactions, vendors, cards, and spending restrictions for better validation and documentation. New audit log event types — Added RFX (Request for X) and sourcing event types to audit logs including RFX creation, vendor management, clarification processes, and sourcing event status changes. January 28, 2026 New purchase order line item management (beta) — Add, update, and delete line items on existing purchase orders. View add endpoint, View update endpoint, View delete endpoint New card vault endpoint (beta) — Retrieve sensitive card details by card ID for vault API access holders. View endpoint Default payment method support for bills — Added use_default_payment_method parameter to create bills using vendor's configured default payment method. View endpoint Enhanced vendor data — Added code field to accounting vendors for ERP system vendor codes. Item receipt line item tracking — Added id field to item receipt line items and item_receipt_line_item_ids arrays to bill line items and bill inventory line items for better purchase order tracking. New audit log event types — Added AI custom field config executed, External ticket created zendesk, and User previewed event types. New webhook events — Added purchase_orders.archived, reimbursements.sync_requested, and transactions.sync_requested webhook event types. Additional managed portfolio accounts — Added new managed portfolio account types: MANAGED_PORTFOLIO_INTEREST_INCOME_ACCOUNT, MANAGED_PORTFOLIO_POSITION_ASSET_ACCOUNT, MANAGED_PORTFOLIO_REALIZED_GAIN_LOSS_ACCOUNT, and MANAGED_PORTFOLIO_UNREALIZED_GAIN_LOSS_ACCOUNT. January 22, 2026 Enhanced item receipts filtering — Added query parameters for filtering item receipts by entity_id, purchase_order_id, and purchase_order_line_item_id, plus include_archived option to include archived receipts and standard pagination with start and page_size. View endpoint New currency support — Added USDB currency code for USD Basecoin across all endpoints that support currency values. New audit log event types — Added support for tracking blank canvas workflow pause status updates, contract combinations, SFTP authentication events, and vendor management expansion request changes in audit logs. Enhanced user management — Added scheduled_deactivation_date field to user objects for scheduling automatic user deactivation on a specific date. View endpoint New SFTP configurations resource type — Added SFTP Configurations as a supported resource type in audit logs for tracking SFTP-related configuration changes. January 16, 2026 Enhanced bill filtering — Added status_summaries query parameter to filter bills by multiple status summaries like APPROVAL_PENDING, PAYMENT_COMPLETED, or DRAFT_READY. View endpoint Tracking category metadata in custom records — Custom record accounting field options now include a tracking_category object with metadata like display name, active status, and accounting provider connection status alongside the existing tracking_category_uuid. January 14, 2026 New accounting connection update endpoint (beta) — Update settings for API-based accounting connections, including vendor credits configuration. View endpoint Enhanced reimbursement filtering — Added state query parameter to filter reimbursements by status including APPROVED, AWAITING_EXPORT, PENDING, REIMBURSED, and other states. View endpoint New vendor credits endpoints (beta) — Retrieve vendor credits across all vendors or for specific vendors with filtering by accounting dates and usage status. View endpoint Individual vendor credit retrieval (beta) — Fetch detailed information about a specific vendor credit including line items, applied bills, and remaining amounts. View endpoint Vendor-specific credit listing (beta) — List vendor credits for a specific vendor with the same filtering options as the global endpoint. View endpoint New audit log event types — Added Card delivered, Reimbursement submitted, Reimbursements disabled, and Reimbursements enabled event types for enhanced audit tracking. Custom form comments support — All custom form field responses now include an optional comment field for additional context on responses. Enhanced custom form entity support — Added vendors to the list of supported entity types for custom forms alongside existing entities like bills, users, and transactions. January 6, 2026 New webhook event — Added spend_requests.comment_created event type for webhooks to notify when comments are created on spend requests. Enhanced custom records relationships — Added relationship metadata to tracking category fields in custom record line items for improved data linking between tracking categories and custom field options. Custom records tracking category requirement — Added tracking_category_uuid as a required field for native reference column types in custom records, enabling better integration with accounting field options. January 5, 2026 Multiple purchase orders per bill — Bills can now be linked to multiple purchase orders using the purchase_order_ids array field in both create and update operations, replacing the previous single purchase_order_id field. View endpoint December 23, 2025 ERP migration tool — Set up a new API-based accounting connection to seamlessly migrate from your current ERP to a new one. View guide Enhanced bills filtering — Added invoice_number query parameter to filter bills by exact invoice number. View endpoint Enhanced receipts filtering — Added reimbursement_id query parameter to filter receipts for a specific reimbursement. View endpoint Enhanced users filtering — Added status query parameter to filter users by status (USER_ACTIVE, USER_INACTIVE, USER_SUSPENDED), replacing the deprecated include_deleted parameter. View endpoint Enhanced accounting field filtering — Added is_active and code query parameters for filtering custom accounting fields and field options by active status and code. View endpoint New vendor bank account archiving — Archive vendor bank accounts with automatic transfer of associated bills, drafts, and recurring templates to a replacement account. View endpoint New currency support — Added CNH (Chinese Yuan Renminbi offshore) to supported currencies across bill and purchase order endpoints. New DATE input type — Added DATE enum value for custom accounting field input types, supporting ISO format (YYYY-MM-DD) in free form text fields. Enhanced audit log events — Added new vendor management agreement event types including document operations (deleted document, linked document, uploaded document) and purchase order operations (linked purchase order, unlinked purchase order). Enhanced attachment types — Added EMAIL and VENDOR_CREDIT enum values for bill attachment types. Provider name fields — Added provider_name field to custom accounting fields, field options, GL accounts, and vendors to identify the accounting connection source. Reimbursement payment tracking — Added payment_batch_id field to reimbursements for tracking payment batch associations. December 11, 2025 Enhanced vendor filtering — Added external_vendor_id query parameter to filter vendors by customer-defined external identifiers, independent of accounting system remote IDs. View endpoint External vendor ID support — Added external_vendor_id field to vendor creation, updates, and responses for tracking customer-defined identifiers separate from accounting system remote IDs. View endpoint Purchase order line item matching — Added purchase_order_line_item_id field to bill line items for tracking matched purchase order line items. View endpoint Real-time payment support — Added RTP enum value for Real-Time Payment processing method. Same-day bill payments — Added is_same_day parameter to enable same-day delivery for eligible ACH payments when creating bill payments. View endpoint Spend program line item fields — Added line_item_accounting_fields to spend program responses, showing custom accounting fields enabled for line items in each program. View endpoint New audit log event — Added Vendor management agreement notification type switched event type for vendor management tracking. Form 1099 compliance type — Added FORM_1099 enum value to vendor compliance types for tax reporting requirements. Enhanced date filtering — Improved transaction filtering parameters with explicit ISO8601 format specification for synced_after, from_date, and to_date parameters. View endpoint Draft bill tracking — Added draft_bill_created_at field to bill responses for tracking when bills were originally created as drafts. View endpoint December 4, 2025 Delete matrix table rows — Remove individual rows from custom matrix tables using the delete endpoint. View endpoint Matrix table row IDs — Matrix table rows now include an id field for unique identification and row-level operations. Number column support for custom tables — Create and use number columns in custom tables with the new number column type for numerical data storage. Default entity for vendors — Added default_entity_id field to vendors for associating a default business entity with vendor records. New procurement event type — Added Procurement agent run completed enum value for audit log events tracking procurement automation completion. November 28, 2025 New limited edition card designs — Added holiday-themed card design options including limited_edition_gifts, limited_edition_gingerbread_man, limited_edition_grinch, limited_edition_hot_cocoa, limited_edition_reindeer, limited_edition_santa, and limited_edition_snowman enum values for card customization. November 26, 2025 Bill accounting sync control — Added enable_accounting_sync boolean field to bill responses that indicates whether the bill should sync to the ERP system. View endpoint Manual vendor payment method — Added MANUAL enum value to vendor payment method kind field for manually processed payments. New accrual AP account type — Added ACCRUAL_AP_ACCOUNT enum value for accrual accounts payable account usage type. Enhanced custom field values — Custom field values now support number type in addition to boolean and string types. November 24, 2025 Enhanced bill creation — Added enable_accounting_sync field to control whether bills sync to your ERP system, with additional validation when using remote_id. View endpoint Matrix table column management (beta) — Add result columns to existing matrix tables without modifying input columns via POST /developer/v1/custom-records/matrix-tables/{table_name}/columns. View endpoint Matrix table column renaming (beta) — Change the API name of matrix table columns while preserving human-readable labels via PATCH /developer/v1/custom-records/matrix-tables/{table_name}/columns/{column_name}. View endpoint Number column support for matrix tables (beta) — Matrix tables now support number input columns in addition to reference columns, enabling numeric thresholds and values in matrix configurations. Enhanced vendor data — Vendor accounts now include accounting_connection_id field to identify which accounting connection the vendor is associated with. View endpoint New audit log events — Added "Vendor management agreement status changed" and "Vendor management edited agreement field" event types for tracking vendor agreement modifications. November 20, 2025 New audit log event type — Added Created fund from purchase order enum value to track fund creation events from purchase orders in audit logs. Enhanced user filtering — Added COORDINATOR role to user role filtering options for better user management capabilities. View endpoint New accounting sync type — Added REPAYMENT_SYNC enum value for repayment synchronization via the object sync endpoint. View endpoint November 18, 2025 Update purchase order support (beta) — Update existing purchase orders with new accounting field selections, line items, and spend date ranges via PATCH /developer/v1/purchase-orders/{purchase_order_id}. View endpoint Change custom table row external key (beta) — Update the external key identifier for existing custom table rows via PATCH /developer/v1/custom-records/custom-tables/{custom_table_name}/rows/{row_id}. View endpoint Enhanced bill payment methods — Added LOCAL_BANK_TRANSFER payment method for creating bill payments alongside existing options like CHECK, DOMESTIC_WIRE, and SWIFT. Flexible accounting field selections — Accounting field selections now support free_form_text as an alternative to field_option_external_id, allowing custom text values when predefined options aren't available. Improved quantity handling — Line item quantity fields now use number type instead of integer for more precise quantity tracking across bills, purchase orders, and item receipts. Enhanced user validation — Added 50-character limits for first_name and last_name fields, and minimum length validation for vendor names to ensure data quality. November 12, 2025 New trips endpoints (beta) — List all trips for your business with filtering by user IDs, status, date ranges, amount ranges, and trip names, or fetch individual trips by ID. Includes trip details like locations, spend events, total spend, and travel types. List trips | Get trip Enhanced custom records matrix filtering — Added filters parameter to filter matrix table rows by input column values using the new column filter structure with column_name and one_of matching. View endpoint November 10, 2025 Enhanced entity filtering — Added hide_inactive parameter to entity endpoints to filter out inactive entities. View endpoint New workflow base type — Added Workflow (Base) enum value for custom record types to distinguish base workflow configurations from standard workflows. November 7, 2025 Enhanced bill filtering by payment date — Added from_payment_date and to_payment_date parameters to the List Bills endpoint for filtering bills by their payment dates. View endpoint New Matrix tables for Custom Records (beta) — Create and manage lookup tables where unique input combinations map to result values, with endpoints for table creation, row management, and cell operations. View endpoints Enhanced spend program details — The Get Spend Program endpoint now includes custom_form_collection for form requirements and expanded response schema with detailed program information. View endpoint New vendor default payment method — Added default_payment_method field to vendor responses, showing the configured payment policy and update source for each vendor. November 4, 2025 Enhanced vendor filtering — Added accounting_vendor_remote_ids and vendor_tracking_category_option_ids query parameters to the List Vendors endpoint for filtering by accounting integration data. View endpoint October 31, 2025 New audit log event types — Added Agent access request resolved, Agent access requested, and Set member limit on shared fund event types for tracking agent access workflows and shared fund member limits. October 30, 2025 API Updates and Improvements New audit logs endpoint (beta) — Retrieve audit log events with filtering by user IDs, date ranges, event actor types, and event types. Supports pagination and comprehensive event history tracking. View endpoint Enhanced transaction filters — Added has_been_approved, all_requirements_met_and_approved, and has_statement parameters to filter transactions by approval status, requirements completion, and statement presence. The sync_ready parameter is now deprecated in favor of using sync_status with SYNC_READY. Enhanced user endpoints — Added include_deleted parameter to include deleted users in list responses. Enhanced reimbursements filtering — Added has_been_approved parameter to filter reimbursements by approval status. Enhanced purchase orders filtering — Added spend_request_id parameter to filter purchase orders by associated spend request. New accounting sync type — Added AMORTIZATION_ENTRY_SYNC enum value for amortization entry synchronization. New payment method type — Added CRYPTO_WALLET_TRANSFER enum value for cryptocurrency wallet transfers across bills, reimbursements, and transactions. Enhanced legacy spend allocation creation — Added an accounting_rules parameter to set accounting rules when creating or updating spend allocations and vault cards. Enhanced accounting connections — Updated description for creating accounting connections to clarify Universal CSV connection upgrade behavior, and added connection_type field showing connection type details. September 25, 2025 Vault cards endpoint publicly available — Create virtual cards through the vault endpoint. View endpoint Bill attachment upload support — Upload attachments to existing bills via POST /developer/v1/bills/{bill_id}/attachments. View endpoint Allow negative line items for bill creation — Bills can now include negative line items for credits and adjustments. Enhanced card schema in the legacy spend allocation response — Added cardholder_id, cardholder_name, created_at, and display_name fields to its card data. Legacy spend allocation role filter — Added a user_access_roles query parameter for role-based filtering. Minor unit conversion factor in currency response — Currency data now includes conversion factors for precise calculations. August 8, 2025 New entity relationship documentation — Comprehensive guide for understanding data connections across all Ramp objects. View guide Support for querying draft bills — Retrieve bills in draft status before they're finalized for payment processing. Filter archived bills — GET /bills endpoint now includes archived bills in response data. Filter transactions by spend program — Use spend_program_id parameter in GET /transactions to retrieve spend-program-specific transactions. Receipt affidavit URLs — GET /transactions now includes receipt affidavit URLs directly in the response for compliance workflows. Foreign exchange rates in bills — GET /bills now provides FX conversion rates for international payment processing. Vendor payment details management — Add and update vendor bank account information via POST /vendors/{vendor_id}/update-bank-accounts. View endpoint June 25, 2025 Filter purchase orders by spend request timeframe — Use spend_start_date and spend_end_date to retrieve POs tied to a specific spend window. New endpoint: POST /reimbursement/mileage — Log and submit mileage reimbursements via API. Search accounting vendors and GL accounts by remote_id — Simplifies mapping to ERP systems. Match bills to purchase orders — Enables programmatic linkage between bills and POs. Include is_manager in user invites — Supports setting manager status when inviting a user via API. Filter purchase orders by user_id — Use GET /purchase-orders with user_id to retrieve POs submitted by a specific user. accounting_date now returned in reimbursements — Available via GET /reimbursements for improved reconciliation workflows. New endpoint: POST /reimbursements/submit-receipt — Attach receipts directly to reimbursements via API. Auto-match uploaded receipts using OCR — POST /receipts can now automatically associate receipts with matching transactions. Temporary fund increases — Use PATCH /funds/{fund_id} to implement temporary spending boosts. Control declined transaction visibility — GET /transactions now defaults to excluding declines. Use state=DECLINED or state=ALL to include them. Search by accounting field selections — Filter transactions and bills based on assigned accounting fields for better categorization. Custom forms support for legacy spend allocations — Added custom form metadata to Vendors, Purchase Orders, Transactions, and legacy spend allocation responses. May 16, 2025 API Updates New endpoint POST /connection//reactivate Support for specifying display_name on POST /accounting/fields New field card_present to GET /transactions Filter by employee_id for GET /transactions and GET /reimbursements Support for updating accounting custom field display_name New field accounting_date to GET /bills Support for requesting payment and tax details via email on POST /vendors Deprecated: GET /accounting/connection in favor of GET /accounting/all-connections Filter by awaiting_approval_by_user_id in GET /transactions and GET /reimbursements April 29, 2025 Support for creating vendors when approval policies are in place Filter bills by payee_id and sync_status parameters Support for managing vendor addresses via vendor APIs Ability to specify employee_id on user creation New fields status and last_linked_at to GET /accounting/connections New field transaction_accounting_date to transactions APIs Filter transactions by approval_status parameter Filter accounting custom field options by remote_code parameter Beta: Procurement API now available for Ramp Plus customers to manage Purchase Orders and Item Receipts for procurement workflows. Contact your Ramp representative for more information March 25, 2025 New sync_status field to Transactions, Reimbursements, Transfers, and Cashbacks for tracking sync state Filter with sync_status query parameter to retrieve records based on their sync state Query Accounting Custom Fields and Options by remote_id parameter for easier external system mapping Mark Accounting Custom Fields as required to enforce validation before sync-ready status Ramp MCP Server — Enables developers to expose business data through an LLM-friendly SQL interface. Available as a Python package with support for custom tools, data loaders, and SQL execution. View on GitHub or read our blog post February 25, 2025 Beta: Custom Records now available for Ramp Plus customers to add custom fields to users for advanced workflows (e.g., Cost Center, Division, Custom Approvers). Define and manage custom or native tables via CSV, SCIM, or API. Contact your Ramp representative for more information New endpoint GET /developer/v1/bank-accounts/{bank_account_id} to retrieve linked bank account information January 17, 2025 Bills and Vendors API Launch New: Manage vendors, bills, and payments via API for your Accounts Payable workflows All endpoints are accessible in both Sandbox and Production environments Support for creating, updating, deleting, and retrieving Vendors, Vendor Contacts, and Bills May 2024 Deprecation Notice: Legacy Cards API Deprecated: Ramp is transitioning from the legacy Cards API to the Funds and type-specific Cards APIs Use the Funds API for virtual card issuance and fund lifecycle management Funds support one-to-many relationships between funds and cards, including shared funds across users Use the Cards (Physical) API for physical card creation, shipping, and lifecycle management