> ## Documentation Index > Fetch the complete documentation index at: https://exsited.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Convert a quote to an order > Turns a quote into a new regular order and returns the new order under `order`. Send an empty body. The new order has its own `id` and `order_type` `REGULAR`, and the quote stays readable with `quote_converted` set to `true`. > [!NOTE] > > The SDK samples get their client from credentials your app registers once when it starts, as shown in [Authentication](https://exsited.mintlify.site/authentication.md#set-up-a-client). To try the call here, click **Try it**, set `host` to your Exsited API host name and paste an access token from [Get an access token](https://exsited.mintlify.site/api-reference/authentication/get-an-access-token.md). To send a raw JSON body instead of filling in fields, copy the cURL sample and edit its `-d` payload. ## OpenAPI ````yaml POST /orders/{order_id}/convert_to_order openapi: 3.1.0 info: title: Exsited API version: v4 servers: - url: https://{host}/api/v4 variables: host: default: your-api-host.example.com description: Your Exsited API host name, without https://. security: - bearerAuth: [] tags: - name: Authentication - name: Accounts - name: Account emails - name: Account groups - name: Communications - name: Communication profiles - name: Orders - name: Quote orders - name: Express - name: Usages - name: Sales reps - name: Gift certificates - name: Invoices - name: Pro-forma invoices - name: Payments - name: Refunds - name: Credit notes - name: Credit note applications - name: Reconciliations - name: Items - name: Inventory adjustments - name: Units of measurement - name: Zones - name: Shipping packages - name: Shipping rules - name: Fulfillment profiles - name: Fulfillment terms - name: Item fulfillments - name: Item receipts - name: Bookings - name: Rental assets - name: Return merchandise authorisations - name: Purchase orders - name: Purchase invoices - name: Purchase payments - name: Purchase refunds - name: Purchase credit notes - name: Purchase credit note applications - name: Purchase express - name: Return vendor authorizations - name: ABA files - name: Receive terms - name: Labours - name: Tasks - name: Timesheets - name: Milestones - name: Employees - name: Departments - name: Designations - name: Teams - name: Time periods - name: Workflows - name: Workflow settings - name: Events - name: Custom events - name: System events - name: Approvals - name: Approval profiles - name: Approval user groups - name: Alerts - name: Alert responsibility settings - name: Alert responsibilities - name: Action scripts - name: Note groups - name: Note attachments - name: Instance settings - name: Accounting codes - name: Additional codes - name: Billing periods - name: Charging periods - name: Pricing periods - name: Invoice terms - name: Days of the month - name: Countries - name: Salutations - name: Document templates - name: Email templates - name: Roles - name: Operators - name: Operator groups - name: User settings - name: Custom attributes - name: Custom components - name: Custom features - name: Custom fields - name: Custom forms - name: Attribute attachments - name: Portal - name: Integration connections - name: External databases - name: Reports - name: Applications - name: Organisation - name: Child organisations - name: Webhooks paths: /orders/{order_id}/convert_to_order: post: tags: - Orders summary: Convert a quote to an order description: >- Send an empty body. The new order has its own `id` and `order_type` `REGULAR`, and the quote stays readable with `quote_converted` set to `true`. operationId: orders_create_order_convert_to_order parameters: - name: order_id in: path required: true description: >- The quote's order `id`. A quote is an order created with `quote_order: true`. schema: type: string requestBody: required: true content: application/json: schema: type: object properties: {} example: {} responses: '200': description: The new regular order, under `order`. content: application/json: schema: $ref: '#/components/schemas/OrderReadResponse' x-codeSamples: - lang: bash label: cURL source: >- curl -X POST "$EXSITED_BASE_URL/api/v4/orders/ORD-0002/convert_to_order" \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{}' - lang: python label: Python source: > from exsited import build_client client = build_client() response = client.orders.create_order_convert_to_order("ORD-0002", {}) print(response.data) - lang: javascript label: JavaScript source: > import {buildClient} from 'exsited'; const client = await buildClient(); const response = await client.orders.createOrderConvertToOrder('ORD-0002', {}); console.log(response.data); - lang: php label: PHP source: > use Exsited\Client\ClientRegistry; $client = ClientRegistry::buildClient(); $response = $client->orders->createOrderConvertToOrder('ORD-0002', '{}'); print_r($response->data); - lang: java label: Java source: > import com.exsited.client.ApiResponse; import com.exsited.client.ClientRegistry; import com.exsited.client.ExsitedClient; import com.exsited.resources.orders.orders_dto.OrdersDto.OrderRead; import java.util.Map; ExsitedClient client = ClientRegistry.buildClient(); ApiResponse response = client.orders().createOrderConvertToOrder("ORD-0002", Map.of()); System.out.println(response.getMap()); - lang: csharp label: .NET source: | using Exsited.Client; await using var client = ExsitedClient.BuildClient(); var response = await client.Orders.CreateOrderConvertToOrderAsync( "ORD-0002", new Dictionary()); Console.WriteLine(response.Json); - lang: dart label: Dart source: | import 'package:exsited/exsited.dart'; final client = buildClient(); final response = await client.orders.createOrderConvertToOrder( 'ORD-0002', {}, ); print(response.map); - lang: go label: Go source: "import (\n\t\"context\"\n\t\"fmt\"\n\t\"log\"\n\n\texsited \"github.com/exsited/exsited-sdk-go/v4\"\n)\n\nclient, err := exsited.BuildClient(nil)\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer client.Close()\n\nresponse, err := client.Orders().CreateOrderConvertToOrder(context.Background(), \"ORD-0002\", map[string]any{}, nil)\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Println(response.Map)\n" components: schemas: OrderReadResponse: type: object properties: order: $ref: '#/components/schemas/OrderRead' OrderRead: type: object properties: account: $ref: '#/components/schemas/OrderReadAccount' activity_logs: type: array items: $ref: '#/components/schemas/OrderReadActivityLog' allow_contract: type: boolean billing_address: $ref: '#/components/schemas/OrderReadBillingAddress' billing_preferences: $ref: '#/components/schemas/OrderReadBillingPreferences' billing_start_date: type: string billing_start_day_of_month: type: string communication_preferences: type: array items: $ref: '#/components/schemas/OrderReadCommunicationPreference' contract_properties: $ref: '#/components/schemas/OrderReadContractProperties' created_by: {} created_on: type: string currency: $ref: '#/components/schemas/OrderReadCurrency' custom_attributes: type: array items: $ref: '#/components/schemas/OrderReadCustomAttribute' custom_form: $ref: '#/components/schemas/OrderReadCustomForm' customer_purchase_order_id: type: string description: type: string discount_profile: $ref: '#/components/schemas/OrderReadDiscountProfile' display_name: type: string id: type: string invoice_note: type: string kpis: $ref: '#/components/schemas/OrderReadKpis' last_updated_by: {} last_updated_on: type: string lines: type: array items: $ref: '#/components/schemas/OrderReadLine' manager: $ref: '#/components/schemas/OrderReadManager' name: type: string next_billing_from_date: type: string next_billing_from_date_utc: type: string object: type: string order_start_date: type: string order_type: type: string origin: type: string original_total: type: string pre_order: type: boolean price_tax_inclusive: type: boolean quote_converted: type: boolean quote_order: type: boolean referral_account: {} sales_rep: {} shipping_address: $ref: '#/components/schemas/OrderReadShippingAddress' shipping_cost: type: number shipping_line_items: type: array shipping_profile: {} status: type: string subtotal: type: string tax: type: string time_zone: $ref: '#/components/schemas/OrderReadTimeZone' total: type: string version: type: integer OrderReadAccount: type: object properties: object: type: string id: type: string name: type: string href: type: string OrderReadActivityLog: type: object properties: activity: type: string OrderReadBillingAddress: type: object properties: address_line_1: type: string address_line_2: type: string address_line_3: type: string address_line_4: type: string address_line_5: type: string city: type: string country: type: string name: type: string postal_code: type: string state: type: string OrderReadBillingPreferences: type: object properties: billing_period: type: string communication_profile: type: string consolidate_invoice: type: boolean consolidate_key: type: string fulfillment_mode: type: string fulfillment_term: type: string invoice_mode: type: string invoice_term: type: string payment_mode: type: string payment_processor: type: string payment_term: type: string payment_term_alignment: type: string proforma_properties: $ref: '#/components/schemas/OrderReadBillingPreferencesProformaProperties' OrderReadCommunicationPreference: type: object properties: channel: type: string enabled: type: boolean OrderReadContractProperties: type: object properties: allow_downgrade: type: boolean allow_early_termination: type: boolean allow_postponement: type: boolean allow_trial: type: boolean allow_upgrade: type: boolean apply_early_termination_charge: type: boolean auto_renewal_ends_on: type: string auto_renewal_require_customer_acceptance: type: boolean auto_renewal_term: type: string early_termination_charge_type: type: string early_termination_minimum_period: type: string initial_contract_term: type: string renew_automatically: type: string require_customer_acceptance: type: boolean requires_payment_method: type: boolean start_contract_after_trial_ends: type: boolean termination_accounting_code: type: string termination_fixed_charge: type: string termination_notice_period: type: string trial_end_date: type: string trial_period: type: string trial_requires_payment_method: type: boolean OrderReadCurrency: type: object properties: code: type: string href: type: string id: type: string name: type: string object: type: string OrderReadCustomAttribute: type: object properties: href: type: string id: type: string name: type: string object: type: string type: type: string value: type: object OrderReadCustomForm: type: object properties: object: type: string id: type: string name: type: string href: type: string OrderReadDiscountProfile: type: object properties: amount: type: string href: type: string id: type: string name: type: string object: type: string redemption_code: type: string type: type: string OrderReadKpis: type: object properties: created_on: {} deleted_at: {} estimated_total: type: string last_cancelled_at: {} last_changed_at: {} last_invoice_issue_date: {} last_invoice_total: type: string last_reactivated_at: {} last_updated_on: {} monthly_recurring_revenue: type: string next_invoice_issue_date: {} object: type: string start_date: {} total_collected: type: string total_due: type: string total_invoice: type: integer total_outstanding: type: string total_revenue: type: string OrderReadLine: type: object properties: booking: $ref: '#/components/schemas/OrderReadLineBooking' charge_item_uuid: type: string expected_delivery_date: type: string id: type: string item: $ref: '#/components/schemas/OrderReadLineItem' item_accounting_code: $ref: '#/components/schemas/OrderReadLineItemAccountingCode' item_charge_type: type: string item_custom_attributes: type: array items: $ref: '#/components/schemas/OrderReadLineItemCustomAttribute' item_description: type: string item_invoice_note: type: string item_order_quantity: type: integer item_price_snapshot: $ref: '#/components/schemas/OrderReadLineItemPriceSnapshot' item_price_tax: $ref: '#/components/schemas/OrderReadLineItemPriceTax' item_properties: $ref: '#/components/schemas/OrderReadLineItemProperties' item_sale_tax_configuration: $ref: '#/components/schemas/OrderReadLineItemSaleTaxConfiguration' item_type: type: string object: type: string pre_order_stock_details: $ref: '#/components/schemas/OrderReadLinePreOrderStockDetails' shipping_cost: type: number subtotal: type: string tax: type: string tax_exempt_when_sold: type: boolean total: type: string version: type: integer OrderReadManager: type: object properties: object: type: string id: type: string name: type: string href: type: string OrderReadShippingAddress: type: object properties: address_line_1: type: string address_line_2: type: string address_line_3: type: string address_line_4: type: string address_line_5: type: string city: type: string country: type: string name: type: string postal_code: type: string state: type: string OrderReadTimeZone: type: object properties: object: type: string id: type: string name: type: string href: type: string OrderReadBillingPreferencesProformaProperties: type: object properties: acceptance_date: {} acceptance_required: type: boolean acceptance_term: {} payment_required: type: boolean terms_and_conditions: {} OrderReadLineBooking: type: object properties: booking_end_time: type: string booking_start_time: type: string labour_uuid: type: string OrderReadLineItem: type: object properties: href: type: string id: type: string name: type: string object: type: string uuid: type: string OrderReadLineItemAccountingCode: type: object properties: sales_revenue: {} OrderReadLineItemCustomAttribute: type: object properties: name: type: string value: type: object OrderReadLineItemPriceSnapshot: type: object properties: pricing_rule: $ref: '#/components/schemas/OrderReadLineItemPriceSnapshotPricingRule' OrderReadLineItemPriceTax: type: object properties: href: type: string id: type: string name: type: string object: type: string rate: type: number OrderReadLineItemProperties: type: object properties: billing_mode: type: string charging_and_billing_alignment: type: string charging_period: type: string charging_start_date: type: string pro_rata_partial_charging_period: type: string pro_rata_partial_pricing_period: type: string OrderReadLineItemSaleTaxConfiguration: type: object properties: sale_price_is_based_on: type: string tax_code: $ref: '#/components/schemas/OrderReadLineItemSaleTaxConfigurationTaxCode' OrderReadLinePreOrderStockDetails: type: object properties: pending_reserve: type: string reserved: type: string sold: type: string OrderReadLineItemPriceSnapshotPricingRule: type: object properties: price: type: number price_period: type: string price_type: type: string pricing_level: type: string pricing_method: type: string pricing_schedule: type: string uom: type: string uuid: type: string version: type: string warehouse: type: string OrderReadLineItemSaleTaxConfigurationTaxCode: type: object properties: code: type: string link: type: string rate: type: object uuid: type: string securitySchemes: bearerAuth: type: http scheme: bearer description: >- An access token from `POST /api/v4/oauth2/token`. The SDKs get and renew it for you. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.