ESC
Start typing to search documentation...
JoonWeb Dev

Orders Endpoints

Detailed technical documentation and implementation guide for Orders Endpoints.

Overview #

List orders #

GET /api/admin/26.0/orders

Parameters

Field Type Description
limit integer [Optional] Number of results to return (default 20, max 10000)
page integer [Optional] Page number to fetch (default 1)
sort_by string [Optional] Field to sort by (e.g. created_at, title)
sort_order string [Optional] Sort direction: asc or desc
status string [Optional] Filter by status (open, closed, cancelled)
financial_status string [Optional] Filter by financial status (paid, pending)
fulfillment_status string [Optional] Filter by fulfillment (fulfilled, partial)
customer_id integer [Optional] Filter by customer ID

Headers

Header Value
X-Joonweb-Access-Token jw_at_xxxxxxxxxxxx
Content-Type application/json
Request Example
Response
200 OK 
{
    "orders": [
        {
            "id": 104938,
            "email": "[email protected]",
            "created_at": "2026-08-27T11:31:04+02:00",
            "updated_at": "2026-08-27T11:31:04+02:00",
            "number": 1004,
            "order_number": "#1004",
            "total_price": 149.990000000000009094947017729282379150390625,
            "subtotal_price": 149.990000000000009094947017729282379150390625,
            "total_weight": 0.450000000000000011102230246251565404236316680908203125,
            "total_tax": 0,
            "taxes_included": false,
            "currency": "USD",
            "financial_status": "paid",
            "fulfillment_status": "unfulfilled",
            "total_discounts": 0,
            "total_line_items_price": 149.990000000000009094947017729282379150390625,
            "customer": {
                "id": 84920,
                "first_name": "Jane",
                "last_name": "Doe",
                "email": "[email protected]",
                "phone": "+15550198273",
                "accepts_marketing": true,
                "orders_count": 4,
                "total_spent": 549.9600000000000363797880709171295166015625,
                "currency": "USD",
                "state": "enabled",
                "created_at": "2026-08-27T11:31:04+02:00",
                "updated_at": "2026-08-27T11:31:04+02:00",
                "default_address": {
                    "id": 10293,
                    "first_name": "Jane",
                    "last_name": "Doe",
                    "company": "Doe Tech",
                    "address1": "123 Developer Way",
                    "address2": "Suite 100",
                    "city": "San Francisco",
                    "province": "California",
                    "country": "United States",
                    "zip": "94105",
                    "phone": "+15550198273",
                    "province_code": "CA",
                    "country_code": "US",
                    "country_name": "United States",
                    "default": true
                }
            },
            "line_items": [
                {
                    "id": 48291,
                    "variant_id": 4920,
                    "product_id": 104593,
                    "title": "Premium Wireless Headphones",
                    "quantity": 1,
                    "sku": "ATH-BLK-01",
                    "price": 149.990000000000009094947017729282379150390625,
                    "vendor": "AudioTech",
                    "fulfillment_status": "unfulfilled",
                    "taxable": true
                }
            ],
            "billing_address": {
                "id": 10293,
                "first_name": "Jane",
                "last_name": "Doe",
                "company": "Doe Tech",
                "address1": "123 Developer Way",
                "address2": "Suite 100",
                "city": "San Francisco",
                "province": "California",
                "country": "United States",
                "zip": "94105",
                "phone": "+15550198273",
                "province_code": "CA",
                "country_code": "US",
                "country_name": "United States",
                "default": true
            },
            "shipping_address": {
                "id": 10293,
                "first_name": "Jane",
                "last_name": "Doe",
                "company": "Doe Tech",
                "address1": "123 Developer Way",
                "address2": "Suite 100",
                "city": "San Francisco",
                "province": "California",
                "country": "United States",
                "zip": "94105",
                "phone": "+15550198273",
                "province_code": "CA",
                "country_code": "US",
                "country_name": "United States",
                "default": true
            }
        }
    ],
    "pagination": {
        "current_page": 1,
        "per_page": 20,
        "total": 1,
        "total_pages": 1
    }
}

Get order details #

GET /api/admin/26.0/orders/{id}

Parameters

Field Type Description
id integer/string [Required] The resource ID or handle

Headers

Header Value
X-Joonweb-Access-Token jw_at_xxxxxxxxxxxx
Content-Type application/json
Request Example
Response
200 OK 
{
    "order": {
        "id": 104938,
        "email": "[email protected]",
        "created_at": "2026-08-27T11:31:04+02:00",
        "updated_at": "2026-08-27T11:31:04+02:00",
        "number": 1004,
        "order_number": "#1004",
        "total_price": 149.990000000000009094947017729282379150390625,
        "subtotal_price": 149.990000000000009094947017729282379150390625,
        "total_weight": 0.450000000000000011102230246251565404236316680908203125,
        "total_tax": 0,
        "taxes_included": false,
        "currency": "USD",
        "financial_status": "paid",
        "fulfillment_status": "unfulfilled",
        "total_discounts": 0,
        "total_line_items_price": 149.990000000000009094947017729282379150390625,
        "customer": {
            "id": 84920,
            "first_name": "Jane",
            "last_name": "Doe",
            "email": "[email protected]",
            "phone": "+15550198273",
            "accepts_marketing": true,
            "orders_count": 4,
            "total_spent": 549.9600000000000363797880709171295166015625,
            "currency": "USD",
            "state": "enabled",
            "created_at": "2026-08-27T11:31:04+02:00",
            "updated_at": "2026-08-27T11:31:04+02:00",
            "default_address": {
                "id": 10293,
                "first_name": "Jane",
                "last_name": "Doe",
                "company": "Doe Tech",
                "address1": "123 Developer Way",
                "address2": "Suite 100",
                "city": "San Francisco",
                "province": "California",
                "country": "United States",
                "zip": "94105",
                "phone": "+15550198273",
                "province_code": "CA",
                "country_code": "US",
                "country_name": "United States",
                "default": true
            }
        },
        "line_items": [
            {
                "id": 48291,
                "variant_id": 4920,
                "product_id": 104593,
                "title": "Premium Wireless Headphones",
                "quantity": 1,
                "sku": "ATH-BLK-01",
                "price": 149.990000000000009094947017729282379150390625,
                "vendor": "AudioTech",
                "fulfillment_status": "unfulfilled",
                "taxable": true
            }
        ],
        "billing_address": {
            "id": 10293,
            "first_name": "Jane",
            "last_name": "Doe",
            "company": "Doe Tech",
            "address1": "123 Developer Way",
            "address2": "Suite 100",
            "city": "San Francisco",
            "province": "California",
            "country": "United States",
            "zip": "94105",
            "phone": "+15550198273",
            "province_code": "CA",
            "country_code": "US",
            "country_name": "United States",
            "default": true
        },
        "shipping_address": {
            "id": 10293,
            "first_name": "Jane",
            "last_name": "Doe",
            "company": "Doe Tech",
            "address1": "123 Developer Way",
            "address2": "Suite 100",
            "city": "San Francisco",
            "province": "California",
            "country": "United States",
            "zip": "94105",
            "phone": "+15550198273",
            "province_code": "CA",
            "country_code": "US",
            "country_name": "United States",
            "default": true
        }
    }
}

Create order #

POST /api/admin/26.0/orders

Parameters

Field Type Description
email string [Optional] Customer email
line_items array [Required] Array of items in the checkout
line_items[].variant_id integer [Required] The ID of the product variant
line_items[].quantity integer [Required] The quantity to add
shipping_address object [Optional] Shipping address object
shipping_address.first_name string [Optional] First name
shipping_address.last_name string [Optional] Last name
shipping_address.address1 string [Optional] Line 1 of the address
shipping_address.city string [Optional] City name
shipping_address.zip string [Optional] Postal/Zip code
shipping_address.country string [Optional] Country name or code
billing_address object [Optional] Billing address (same format as shipping_address)
customer_id integer [Optional] ID of existing customer
financial_status string [Optional] paid, pending, refunded
currency string [Optional] Currency code (e.g. USD)

Headers

Header Value
X-Joonweb-Access-Token jw_at_xxxxxxxxxxxx
Content-Type application/json
Request Example
Request Body 
{
    "order": {
        "email": "[email protected]",
        "customer_id": 5432,
        "financial_status": "paid",
        "currency": "USD",
        "line_items": [
            {
                "variant_id": 10245,
                "quantity": 1
            }
        ],
        "shipping_address": {
            "first_name": "John",
            "last_name": "Doe",
            "address1": "123 Main St",
            "city": "New York",
            "zip": "10001",
            "country": "US"
        }
    }
}
Response
200 OK 
{
    "order": {
        "id": 104938,
        "email": "[email protected]",
        "created_at": "2026-08-27T11:31:04+02:00",
        "updated_at": "2026-08-27T11:31:04+02:00",
        "number": 1004,
        "order_number": "#1004",
        "total_price": 149.990000000000009094947017729282379150390625,
        "subtotal_price": 149.990000000000009094947017729282379150390625,
        "total_weight": 0.450000000000000011102230246251565404236316680908203125,
        "total_tax": 0,
        "taxes_included": false,
        "currency": "USD",
        "financial_status": "paid",
        "fulfillment_status": "unfulfilled",
        "total_discounts": 0,
        "total_line_items_price": 149.990000000000009094947017729282379150390625,
        "customer": {
            "id": 84920,
            "first_name": "Jane",
            "last_name": "Doe",
            "email": "[email protected]",
            "phone": "+15550198273",
            "accepts_marketing": true,
            "orders_count": 4,
            "total_spent": 549.9600000000000363797880709171295166015625,
            "currency": "USD",
            "state": "enabled",
            "created_at": "2026-08-27T11:31:04+02:00",
            "updated_at": "2026-08-27T11:31:04+02:00",
            "default_address": {
                "id": 10293,
                "first_name": "Jane",
                "last_name": "Doe",
                "company": "Doe Tech",
                "address1": "123 Developer Way",
                "address2": "Suite 100",
                "city": "San Francisco",
                "province": "California",
                "country": "United States",
                "zip": "94105",
                "phone": "+15550198273",
                "province_code": "CA",
                "country_code": "US",
                "country_name": "United States",
                "default": true
            }
        },
        "line_items": [
            {
                "id": 48291,
                "variant_id": 4920,
                "product_id": 104593,
                "title": "Premium Wireless Headphones",
                "quantity": 1,
                "sku": "ATH-BLK-01",
                "price": 149.990000000000009094947017729282379150390625,
                "vendor": "AudioTech",
                "fulfillment_status": "unfulfilled",
                "taxable": true
            }
        ],
        "billing_address": {
            "id": 10293,
            "first_name": "Jane",
            "last_name": "Doe",
            "company": "Doe Tech",
            "address1": "123 Developer Way",
            "address2": "Suite 100",
            "city": "San Francisco",
            "province": "California",
            "country": "United States",
            "zip": "94105",
            "phone": "+15550198273",
            "province_code": "CA",
            "country_code": "US",
            "country_name": "United States",
            "default": true
        },
        "shipping_address": {
            "id": 10293,
            "first_name": "Jane",
            "last_name": "Doe",
            "company": "Doe Tech",
            "address1": "123 Developer Way",
            "address2": "Suite 100",
            "city": "San Francisco",
            "province": "California",
            "country": "United States",
            "zip": "94105",
            "phone": "+15550198273",
            "province_code": "CA",
            "country_code": "US",
            "country_name": "United States",
            "default": true
        }
    }
}

Update order #

PUT /api/admin/26.0/orders/{id}

Parameters

Field Type Description
email string [Optional] Customer email
line_items array [Required] Array of items in the checkout
line_items[].variant_id integer [Required] The ID of the product variant
line_items[].quantity integer [Required] The quantity to add
shipping_address object [Optional] Shipping address object
shipping_address.first_name string [Optional] First name
shipping_address.last_name string [Optional] Last name
shipping_address.address1 string [Optional] Line 1 of the address
shipping_address.city string [Optional] City name
shipping_address.zip string [Optional] Postal/Zip code
shipping_address.country string [Optional] Country name or code
billing_address object [Optional] Billing address (same format as shipping_address)
customer_id integer [Optional] ID of existing customer
financial_status string [Optional] paid, pending, refunded
currency string [Optional] Currency code (e.g. USD)

Headers

Header Value
X-Joonweb-Access-Token jw_at_xxxxxxxxxxxx
Content-Type application/json
Request Example
Request Body 
{
    "order": {
        "email": "[email protected]",
        "customer_id": 5432,
        "financial_status": "paid",
        "currency": "USD",
        "line_items": [
            {
                "variant_id": 10245,
                "quantity": 1
            }
        ],
        "shipping_address": {
            "first_name": "John",
            "last_name": "Doe",
            "address1": "123 Main St",
            "city": "New York",
            "zip": "10001",
            "country": "US"
        }
    }
}
Response
200 OK 
{
    "order": {
        "id": 104938,
        "email": "[email protected]",
        "created_at": "2026-08-27T11:31:04+02:00",
        "updated_at": "2026-08-27T11:31:04+02:00",
        "number": 1004,
        "order_number": "#1004",
        "total_price": 149.990000000000009094947017729282379150390625,
        "subtotal_price": 149.990000000000009094947017729282379150390625,
        "total_weight": 0.450000000000000011102230246251565404236316680908203125,
        "total_tax": 0,
        "taxes_included": false,
        "currency": "USD",
        "financial_status": "paid",
        "fulfillment_status": "unfulfilled",
        "total_discounts": 0,
        "total_line_items_price": 149.990000000000009094947017729282379150390625,
        "customer": {
            "id": 84920,
            "first_name": "Jane",
            "last_name": "Doe",
            "email": "[email protected]",
            "phone": "+15550198273",
            "accepts_marketing": true,
            "orders_count": 4,
            "total_spent": 549.9600000000000363797880709171295166015625,
            "currency": "USD",
            "state": "enabled",
            "created_at": "2026-08-27T11:31:04+02:00",
            "updated_at": "2026-08-27T11:31:04+02:00",
            "default_address": {
                "id": 10293,
                "first_name": "Jane",
                "last_name": "Doe",
                "company": "Doe Tech",
                "address1": "123 Developer Way",
                "address2": "Suite 100",
                "city": "San Francisco",
                "province": "California",
                "country": "United States",
                "zip": "94105",
                "phone": "+15550198273",
                "province_code": "CA",
                "country_code": "US",
                "country_name": "United States",
                "default": true
            }
        },
        "line_items": [
            {
                "id": 48291,
                "variant_id": 4920,
                "product_id": 104593,
                "title": "Premium Wireless Headphones",
                "quantity": 1,
                "sku": "ATH-BLK-01",
                "price": 149.990000000000009094947017729282379150390625,
                "vendor": "AudioTech",
                "fulfillment_status": "unfulfilled",
                "taxable": true
            }
        ],
        "billing_address": {
            "id": 10293,
            "first_name": "Jane",
            "last_name": "Doe",
            "company": "Doe Tech",
            "address1": "123 Developer Way",
            "address2": "Suite 100",
            "city": "San Francisco",
            "province": "California",
            "country": "United States",
            "zip": "94105",
            "phone": "+15550198273",
            "province_code": "CA",
            "country_code": "US",
            "country_name": "United States",
            "default": true
        },
        "shipping_address": {
            "id": 10293,
            "first_name": "Jane",
            "last_name": "Doe",
            "company": "Doe Tech",
            "address1": "123 Developer Way",
            "address2": "Suite 100",
            "city": "San Francisco",
            "province": "California",
            "country": "United States",
            "zip": "94105",
            "phone": "+15550198273",
            "province_code": "CA",
            "country_code": "US",
            "country_name": "United States",
            "default": true
        }
    }
}

Delete order #

DELETE /api/admin/26.0/orders/{id}

Parameters

Field Type Description
id integer/string [Required] The resource ID or handle

Headers

Header Value
X-Joonweb-Access-Token jw_at_xxxxxxxxxxxx
Content-Type application/json
Request Example
Response
200 OK 
{
    "success": true,
    "message": "Deleted successfully"
}

List order metafields #

GET /api/admin/26.0/orders/{id}/metafields.json

Parameters

Field Type Description
id integer/string [Required] The resource ID or handle

Headers

Header Value
X-Joonweb-Access-Token jw_at_xxxxxxxxxxxx
Content-Type application/json
Request Example
Response
200 OK 
{
    "metafields": [
        {
            "id": 8492,
            "namespace": "global",
            "key": "title_tag",
            "value": "Buy Premium Headphones Online",
            "value_type": "string",
            "description": "SEO Title Tag",
            "owner_id": 104593,
            "owner_resource": "product",
            "created_at": "2026-08-27T11:31:04+02:00",
            "updated_at": "2026-08-27T11:31:04+02:00"
        }
    ],
    "pagination": {
        "current_page": 1,
        "per_page": 20,
        "total": 1,
        "total_pages": 1
    }
}

Create order metafield #

POST /api/admin/26.0/orders/{id}/metafields.json

Parameters

Field Type Description
id integer/string [Required] The resource ID or handle
namespace string [Required] Grouping namespace
key string [Required] Metafield key
value string [Required] Metafield value
value_type string [Required] string, integer, json, etc.
description string [Optional] Description of the metafield

Headers

Header Value
X-Joonweb-Access-Token jw_at_xxxxxxxxxxxx
Content-Type application/json
Request Example
Response
200 OK 
{
    "metafield": {
        "id": 8492,
        "namespace": "global",
        "key": "title_tag",
        "value": "Buy Premium Headphones Online",
        "value_type": "string",
        "description": "SEO Title Tag",
        "owner_id": 104593,
        "owner_resource": "product",
        "created_at": "2026-08-27T11:31:04+02:00",
        "updated_at": "2026-08-27T11:31:04+02:00"
    }
}

What's Next? #

Last modified: Aug 25, 2026