> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create order

> Create a new order

Create a new order

### Request body

JSON body of type `CreateOrderRequest`.

### Responses

<ResponseField name="201" type="ApiResponse_OrderResponse">
  Order created successfully
</ResponseField>

<ResponseField name="400" type="ErrorResponse">
  Invalid request data
</ResponseField>

<ResponseField name="401" type="ErrorResponse">
  Unauthorized
</ResponseField>

<ResponseField name="403" type="ErrorResponse">
  Forbidden
</ResponseField>

<ResponseField name="422" type="ErrorResponse">
  Validation error
</ResponseField>

<ResponseField name="429" type="ErrorResponse">
  Rate limit exceeded
</ResponseField>

<ResponseField name="500" type="ErrorResponse">
  Internal server error
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://api.stateset.com/api/v1/orders' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{}'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "billing_address": {
        "city": "San Francisco",
        "country": "US",
        "postal_code": "94102",
        "state": "CA",
        "street": "123 Main Street"
      },
      "created_at": "2024-12-09T10:30:00Z",
      "currency": "USD",
      "customer_id": "123e4567-e89b-12d3-a456-426614174000",
      "fulfillment_status": "unfulfilled",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "items": [
        {
          "id": "item-001",
          "product_id": "prod-abc123",
          "product_name": "Wireless Bluetooth Headphones",
          "quantity": 2,
          "sku": "WBH-BLK-001",
          "tax_amount": "8.00",
          "tax_rate": "0.08",
          "total_price": "99.98",
          "unit_price": "49.99"
        }
      ],
      "notes": "Please deliver to back door",
      "order_date": "2024-12-09T10:30:00Z",
      "order_number": "ORD-2024-001234",
      "payment_method_id": "pm_card_visa",
      "payment_status": "pending",
      "shipping_address": {
        "city": "San Francisco",
        "country": "US",
        "postal_code": "94102",
        "state": "CA",
        "street": "123 Main Street"
      },
      "status": "pending",
      "total_amount": "149.99",
      "updated_at": "2024-12-09T10:30:00Z",
      "version": 1
    },
    "errors": null,
    "message": null,
    "meta": null,
    "success": true
  }
  ```
</ResponseExample>