Developer API

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.

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

Spend allocation filtering by member role — The member_roles query parameter on GET /developer/v1/limits now accepts OWNER, COOWNER, and MEMBER values (the COORDINATOR value has been removed). Use this with user_id to filter spend allocations 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.

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 spend limit and card display name descriptions — The display_name field on limits now specifies it is the spend allocation name, separate from each linked card's display_name. The display_name query parameter on the List Limits endpoint clarifies it filters by the limit's display name. View endpoint

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 filtering audit logs: 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 was declined because the amount fell below the per-transaction minimum.

Location entity update side effect clarified — The entity_id field on PATCH /developer/v1/locations/{location_id} now documents that existing users assigned to the location will also be moved 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 bills, draft bills, and other currency fields.

New OAuth scope — Added tasks:read scope for granting read access to tasks.

Date-time support for custom record values — Custom record row value fields now accept date-time formatted strings in addition to numbers, strings, booleans, and arrays.

New ARAVO third-party risk management provider — Added ARAVO to the ThirdPartyRiskManagementProviderType enum.

New PAYEE document version type — Added PAYEE to the RampDocumentVersionType enum for payee document versions.

New allow_none field on tracking category settings — The TrackingCategorySettings schema now includes an allow_none boolean field.

New edit_accounting_merchant vendor action — Vendor response objects now include an edit_accounting_merchant action detail indicating whether the accounting merchant linked to a vendor can be edited, with denial reasons such as archived, matches_payee_vendor, no_payee, and no_permission.

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

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

Card expiration in Vault API response — GET /developer/v1/vault/cards/{card_id} now 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

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.

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

Entity selection setting for accounting connections — Added entity_selection_enabled field to accounting connection settings, allowing you to enable or disable ERP entity selection for API-based accounting connections. 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.

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.

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 limits — The allowed_overage_percent_override field is now available when creating limits and is returned in limit responses. This decimal value (0–100) lets you set a fund-level override for the allowed overage percent, independent of the spend program or business default. View endpoint

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

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.

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

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.

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

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.

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 spend limits — Spend limit responses now include is_exempt_from_policy_agent, and you can update it via PATCH along with existing_expense_policy_agent_exemption_application_rules to control whether the exemption applies retroactively (APPLY_TO_ALL) or only to future transactions (APPLY_TO_NONE). 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.

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.

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