Ramp: Create a bill — request body — body
Create a bill: request body, field body. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Create a bill — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
accounting_field_selections | array | Optional | List of accounting field options selected to code the bill. |
accounting_field_selections[] | Model | Each item | Expand Create a bill — request body — body accounting field selections item |
attachment_id | JSON | Optional | |
attachment_id (anyOf 1) | string | Alternative | UUID of a previously uploaded file to attach to this bill. Default: null Format: uuid |
attachment_id (anyOf 2) | null | Alternative | |
due_at | string | Required within parent | Due date of the bill. Format: date |
enable_accounting_sync | boolean | Optional | A flag you can set to False to prevent this bill from syncing to your ERP. Note: enable_accounting_sync must be True when remote_id is provided. Default: true |
entity_id | string | Required within parent | Associated business entity. Format: uuid |
inventory_line_items | JSON | Optional | |
inventory_line_items (anyOf 1) | array | Alternative | List of inventory line items related to the bill. |
inventory_line_items (anyOf 1)[] | Model | Each item | Expand Create a bill — request body — body inventory line items List of inventory line items related to the bill item |
inventory_line_items (anyOf 2) | null | Alternative | |
invoice_currency | string | Required within parent | Currency of the invoice. One of: AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHE, CHF, CHW, CLF, CLP, CNH, CNY, COP, COU, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, EURC, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MXV, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, OPEN_USD, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLE, SLL, SOS, SRD, SSP, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, USDB, USDC, USDG, USDT, USN, UYI, UYU, UYW, UZS, VED, VES, VND, VUV, WST, XAD, XAF, XAG, XAU, XBA, XBB, XBC, XBD, XCD, XCG, XDR, XOF, XPD, XPF, XPT, XSU, XTS, XUA, XXX, YER, ZAR, ZMW, ZWG, ZWL |
invoice_number | string | Required within parent | The invoice number on the bill. Maximum length: 84 |
issued_at | string | Required within parent | Issued date of the bill. Format: date |
line_items | JSON | Optional | |
line_items (anyOf 1) | array | Alternative | List of line items related to the bill. |
line_items (anyOf 1)[] | Model | Each item | Expand Create a bill — request body — body line items List of line items related to the bill item |
line_items (anyOf 2) | null | Alternative | |
memo | JSON | Optional | |
memo (anyOf 1) | string | Alternative | Memo of the bill. Default: null Maximum length: 1000 |
memo (anyOf 2) | null | Alternative | |
payment_date | string | Optional | For a non-card bill, the date the payment is scheduled to be initiated. If the requested date is unavailable, such as a weekend, bank holiday, past date, or same-day cutoff miss, Ramp schedules the payment for the next available initiation date. Format: date |
payment_details | JSON | Optional | |
payment_details (anyOf 1) | Model | Alternative | Expand Create a bill — request body — body payment details value Payment details for the bill. Expected schema depends on payment_method. Default: null |
payment_details (anyOf 2) | null | Alternative | |
payment_method | string | Optional | Payment method for the bill. Required unless use_default_payment_method is true. Default: UNSPECIFIED One of: ACH, CARD, CHECK, CRYPTO_WALLET_TRANSFER, DOMESTIC_WIRE, INTERNATIONAL, LOCAL_BANK_TRANSFER, ONE_TIME_CARD, ONE_TIME_CARD_DELIVERY, PAID_MANUALLY, SWIFT |
posting_date | JSON | Optional | |
posting_date (anyOf 1) | string | Alternative | The date the bill is posted to the accounting system. Default: null Format: date |
posting_date (anyOf 2) | null | Alternative | |
purchase_order_ids | array | Optional | Unique identifiers of the purchase orders to match this bill to. |
purchase_order_ids[] | string | Each item | Format: uuid |
remote_id | JSON | Optional | |
remote_id (anyOf 1) | string | Alternative | An ID that identifies the bill on the client’s side. An accounting connection is required and enable_accounting_sync must be True when remote_id is provided. Omit remote_id for bills that will not be synced to an accounting provider. Default: null |
remote_id (anyOf 2) | null | Alternative | |
target_payment_arrival_date | JSON | Optional | |
target_payment_arrival_date (anyOf 1) | string | Alternative | For a bill created with use_default_payment_method=true, the target vendor arrival date. Ramp uses this date to compute the latest payment initiation date needed to target vendor arrival. If that initiation date is in the past or after today’s cutoff, Ramp schedules the next valid initiation date. Default: null Format: date |
target_payment_arrival_date (anyOf 2) | null | Alternative | |
use_default_payment_method | boolean | Optional | When set to true, create the bill using the default payment method configured for the vendor. If set to true, payment_method and payment_details should not be provided. Default: false |
use_default_vendor_contact | boolean | Optional | When set to true, create the bill using the default contact configured for the vendor. If set to true, vendor_contact_id should not be provided. Default: false |
vendor_contact_id | JSON | Optional | |
vendor_contact_id (anyOf 1) | string | Alternative | Unique identifier of vendor contact, must be associated with passed vendor. Required unless use_default_vendor_contact is true. Default: null Format: uuid |
vendor_contact_id (anyOf 2) | null | Alternative | |
vendor_id | string | Required within parent | Unique identifier of bill vendor. Format: uuid |
vendor_memo | JSON | Optional | |
vendor_memo (anyOf 1) | string | Alternative | Memo to the vendor. Default: null Maximum length: 400 |
vendor_memo (anyOf 2) | null | Alternative |
Referenced models: Create a bill — request body — body accounting field selections item, Create a bill — request body — body inventory line items List of inventory line items related to the bill item, Create a bill — request body — body line items List of line items related to the bill item, Create a bill — request body — body payment details value