---
title: Orders
description: Manage order creation, configuration, and submission workflows
---

An order is the purchase request of a customer for telecom products and services. It carries
the whole ordering flow: the first configuration, the submit, and the coordination of
fulfillment.

## Order entity

An order in the API represents:

- **Purchase request**: Customer intent to purchase specific telecommunications products
- **Configuration management**: Product selection, pricing calculation, and line item management
- **Workflow orchestration**: Multi-step ordering process with validation and approval stages
- **Fulfillment coordination**: Integration with payment processing and service provisioning

## Key capabilities

- **Order configuration** — Build and configure orders with multiple product line items and pricing calculations.
- **Progressive workflow** — Guide customers through step-by-step ordering with validation at each stage.
- **Price calculation** — Real-time pricing updates with promotional codes and dynamic discounting.
- **Submission management** — Submit completed orders for payment processing and service fulfillment.

## Common use cases

- **Product selection** — Configure orders with multiple telecommunications products and service addons.
- **Pricing calculation** — Calculate real-time pricing with promotional codes and customer-specific discounts.
- **Multi-step checkout** — Guide customers through progressive order configuration and validation workflows.
- **Bulk ordering** — Manage enterprise orders with multiple subscribers and service configurations.

## Related resources

Order entities coordinate with other API resources:

- **Product offerings**: Products selected and configured within order line items
- **Product catalogs**: Product availability and pricing context for order configuration
- **Customers**: Order ownership and billing responsibility
- **Discounts**: Promotional codes and pricing adjustments applied to orders
- **Payment sessions**: Payment processing for submitted order configurations
- **Subscriptions**: Service provisioning and activation following successful order fulfillment

## Next steps

- [List orders](/api-reference/orders.md#tag/orders/GET/orders) — Retrieve all orders you have access to
- [Create order](/api-reference/orders.md#tag/orders/POST/orders) — Create a new order configuration
- [Calculate price](/api-reference/orders.md#tag/orders/POST/orders/{orderId}/calculate-price) — Calculate pricing for order configurations
- [Submit order](/api-reference/orders.md#tag/orders/POST/orders/{orderId}/submit) — Submit order for payment and fulfillment