Ramp: Create a purchase order — request body — body line items item
Create a purchase order: request body, field body / line_items / item. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Create a purchase order — request body — body line items item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
accounting_field_selections | array | Optional | List of accounting field options selected to code the line item. |
accounting_field_selections[] | Model | Each item | Expand Create a bill — request body — body accounting field selections item |
description | JSON | Optional | |
description (anyOf 1) | string | Alternative | Description of the line item. Default: null |
description (anyOf 2) | null | Alternative | |
end_date | JSON | Optional | |
end_date (anyOf 1) | string | Alternative | The date when spending for this line item ends. Default: null Format: date |
end_date (anyOf 2) | null | Alternative | |
external_id | JSON | Optional | |
external_id (anyOf 1) | string | Alternative | An ID that identifies the line item on the client’s side. Must be unique within the purchase order and cannot be updated after creation. Default: null |
external_id (anyOf 2) | null | Alternative | |
start_date | JSON | Optional | |
start_date (anyOf 1) | string | Alternative | The date when spending for this line item begins. Default: null Format: date |
start_date (anyOf 2) | null | Alternative | |
unit_price | JSON | Required within parent | Unit price of the line item. |
unit_price (oneOf 1) | string | Alternative | Format: decimal |
unit_price (oneOf 2) | number | Alternative | |
unit_quantity | JSON | Required within parent | Quantity of the line item. Supports fractional values as a JSON number or decimal string. |
unit_quantity (oneOf 1) | string | Alternative | Format: decimal |
unit_quantity (oneOf 2) | number | Alternative | |
withholding_rate | JSON | Optional | |
withholding_rate (anyOf 1) | JSON | Alternative | Retainage withholding rate for the line item, expressed as a fractional decimal. If set, this line-level rate overrides the purchase order withholding_default_rate for this line item. For example, 0.10 means 10%. Default: null Minimum: 0 Less than: 1 |
withholding_rate (anyOf 1) (oneOf 1) | string | Alternative | Format: decimal |
withholding_rate (anyOf 1) (oneOf 2) | number | Alternative | |
withholding_rate (anyOf 2) | null | Alternative |
Referenced models: Create a bill — request body — body accounting field selections item