--- title: "Pricing" method: GET path: "/billing_new/orders/pricing/v1/{order_id}" tags: ["/billing_new", "/billing_new/orders"] --- # Pricing `GET /billing_new/orders/pricing/v1/{order_id}` ## Request - Base URL: `http://localhost:8000` - URL: `http://localhost:8000/billing_new/orders/pricing/v1/{order_id}` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieves the caller organization's rate-sheet selections and generated line items for an order, as last priced. | authz: allowed_org_types=[provider], min_org_role=operator | authz_personas=[coordinator_org_operators, order_executor_org_operators] | () -> (OrderPricingRes) ## Path parameters - `order_id` string, required ## Response `200` Successful Response - OrderPricingRes: What the order pricing routes return for the caller's organization. - `order_billing_state` OrderBillingState1, required - `schema_version` 1, required - `order_id` string, required - `rate_sheet_selections` RateSheetSelection1[] - `task_group_id` string, required - `relationship_type` 'receivable' | 'executor_payable' | 'driver_payable', required - `counterparty_org_id` string, nullable: Must be a string starting with `org_` - `counterparty_off_chrt_org_data_id` string, nullable - `counterparty_driver_id` string, nullable - `rate_sheet_id` string, nullable, required - `selection_source` 'default' | 'manual', required - `unpriced_reasons` UnpricedReason1[] - `code` 'no_rate_sheet' | 'rate_sheet_not_found' | 'rate_sheet_not_in_effect' | 'rule_not_priced_yet' | 'missing_stops' | 'no_lane_rate' | 'no_location_rate' | 'missing_miles' | 'no_cargo_to_measure' | 'missing_measurements' | 'charged_on_gross_weight' | 'currency_left_out' | 'no_payable_lines' | 'no_receivable_lines_to_share' | 'order_wide_charges_left_out' | 'no_fuel_surcharge_configuration', required - `relationship_type` 'receivable' | 'executor_payable' | 'driver_payable' - `task_group_id` string, nullable - `task_id` string, nullable - `rate_sheet_id` string, nullable - `rule_key` string, uuid4, nullable - `enabled_surcharge_types` OrderBillingSurchargeTypeEnum1[] - `_id` string, required - `owned_by_org_id` string, required: Must be a string starting with `org_` - `created_by_user_id` string, nullable, required: Must be a string starting with `user_` - `created_at_timestamp` string, date-time, required - `last_edited_by_user_id` string, nullable, required: Must be a string starting with `user_` - `last_edited_at_timestamp` string, date-time, required - `invoice_line_items` InvoiceLineItem1[] - `schema_version` 1, required - `invoice_type` 'accounts_receivable' | 'accounts_payable', required - `description` string, required - `quantity` number, required - `unit` 'each' | 'shipment' | 'minute' | 'hour' | 'day' | 'mile' | 'kilometer' | 'pound' | 'kilogram' - `unit_price` number, required - `currency_code` 'USD' | 'CAD' | 'EUR' | 'GBP' | 'MXN' | 'AUD' | 'JPY' | 'CNY' | 'CHF' | 'INR', required - `line_item_type` 'base_rate' | 'additional_mileage' | 'long_distance_mileage' | 'fuel' | 'extra_stop' | 'wait_time' | 'attempt' | 'pick_and_hold' | 'stop_fee' | 'parking' | 'tolls' | 'additional_fee' | 'dispute' | 'equipment' | 'dangerous_goods' | 'special_vehicle' | 'after_hours' | 'weekend' | 'holiday' | 'air_waybill' | 'insurance' | 'off_network_carrier' | 'obc_day_rate' | 'flight_ticket' | 'piece_count' | 'weight' | 'revenue_share' | 'minimum_charge' | 'tracking_device_label' | 'tracking_device_tag' | 'tracking_device_other' | 'tax' | 'adjustment' | 'other', required - `tax_percentage` number, nullable - `counterparty_org_id` string, nullable: Must be a string starting with `org_` - `counterparty_off_chrt_org_data_id` string, nullable - `counterparty_driver_id` string, nullable - `shipper_account_id` string, nullable - `awb_number` string, nullable: IATA Air Waybill number: 3-digit airline prefix + 8-digit serial, e.g. '020-12345678'. - `export_ref__sage__item_id` string, nullable - `order_id` string, nullable - `task_group_id` string, nullable - `billing_period_id` string, nullable - `invoice_id` string, nullable - `rate_sheet_id` string, nullable - `rate_sheet_revision` integer, nullable - `currency_conversion` InvoiceLineItemCurrencyConversion1 - `source_unit_price` number, required - `source_currency_code` 'USD' | 'CAD' | 'EUR' | 'GBP' | 'MXN' | 'AUD' | 'JPY' | 'CNY' | 'CHF' | 'INR', required - `conversion_rate` number, required: Units of the target currency per one unit of source_currency_code. unit_price = source_unit_price * conversion_rate. - `description` string, nullable - `billing_line_key` string, nullable - `generated_by_pricing` boolean - `edited_by_user` boolean - `needs_review` boolean - `task_ids` string[] - `task_short_ids` string[] - `source_order_billing_quote_id` string, nullable - `status` 'draft' | 'approved' | 'finalized' - `owned_by_org_id` string, required: Must be a string starting with `org_` - `created_by_user_id` string, nullable, required: Must be a string starting with `user_` - `created_at_timestamp` string, date-time, required - `last_edited_by_user_id` string, nullable, required: Must be a string starting with `user_` - `last_edited_at_timestamp` string, date-time, required - `_id` string, required - `total_amount` number, required - `unpriced_reasons` UnpricedReason1[] - `code` 'no_rate_sheet' | 'rate_sheet_not_found' | 'rate_sheet_not_in_effect' | 'rule_not_priced_yet' | 'missing_stops' | 'no_lane_rate' | 'no_location_rate' | 'missing_miles' | 'no_cargo_to_measure' | 'missing_measurements' | 'charged_on_gross_weight' | 'currency_left_out' | 'no_payable_lines' | 'no_receivable_lines_to_share' | 'order_wide_charges_left_out' | 'no_fuel_surcharge_configuration', required - `relationship_type` 'receivable' | 'executor_payable' | 'driver_payable' - `task_group_id` string, nullable - `task_id` string, nullable - `rate_sheet_id` string, nullable - `rule_key` string, uuid4, nullable - `task_group_ids` string[]: The order's task groups, in order. - `agreed_prices` OrderAgreedPrice1[]: Relationships priced by a bid or quote; filled when the order is re-priced, empty on a plain read. - `task_group_id` string, required - `relationship_type` 'receivable' | 'executor_payable' | 'driver_payable', required - `counterparty_org_id` string, nullable: Must be a string starting with `org_` - `counterparty_off_chrt_org_data_id` string, nullable - `counterparty_driver_id` string, nullable - `bid_thread_id` string, nullable - `order_billing_quote_id` string, nullable ## Other responses - `422`: Validation Error ## Changes - **2026-11-06** `05afd8b01f0c`: 1 info - endpoint added [Operation history](https://skmtc.dev/chrt/apis/chrt-fastapi/changes/billing_new/orders/pricing/v1/:order_id/get.md) --- [API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) - [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/chrt/apis/chrt-fastapi/revisions/2945f2b4f0cf?raw)