List Orders

GET

https://v3.mangoteeprints.com/api/public/v1/orders

Last modified:2025-08-22 08:08:49

Get list of orders with pagination.

Required permission: read:orders

Security: Only returns orders belonging to the API key owner.

Request

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://v3.mangoteeprints.com/api/public/v1/orders?page&limit&status&from_date&to_date&sort_by&sort_order' \
--header 'X-API-Key;'

Responses

🟢200Successful Response

application/json

Body

Example

{
    "code": "SUCCESS",
    "data": {
        "items": [
            {
                "address_line_1": "123 Main Street",
                "address_line_2": "Suite 100",
                "box_fee": 0,
                "city": "New York",
                "country": "US",
                "created_at": "2025-08-20T16:04:42.675869",
                "created_by": "3f432ee6-2214-4732-a1ed-2462c38c76fa",
                "discount": 0,
                "email": "johndoe@example.com",
                "facility": "TX",
                "first_name": "John",
                "id": "2bf824c3-7f14-41a1-a523-0972c18bd119",
                "items": [
                    {
                        "base_cost": 4.7,
                        "color": "ANTIQUE IRISH GREEN",
                        "inserts": [
                            {
                                "name": "packing_slip",
                                "size": "8.5x11",
                                "url": "https://example.com/packing_slip.pdf"
                            }
                        ],
                        "item_id": "YMVU6MXKH69584EPW8TF7STM",
                        "preview_files": [
                            {
                                "key": "mockup_front_url",
                                "url": "https://example.com/preview_file_1"
                            },
                            {
                                "key": "mockup_back_url",
                                "url": "https://example.com/preview_file_2"
                            }
                        ],
                        "print_files": [
                            {
                                "key": "front",
                                "thumbnail": "https://s3-hn-1.mangoteeprints.com/thumbnail/c4dfdbf1-3097-4a61-af4c-ddc79f6f34ec.png",
                                "url": "https://s3-hn-1.mangoteeprints.com/products/c4dfdbf1-3097-4a61-af4c-ddc79f6f34ec.png"
                            }
                        ],
                        "product_name": "Unisex T-shirt | Gildan 5000",
                        "quantity": 2,
                        "size": "M",
                        "sku": "G05000AIG000M"
                    }
                ],
                "label_url": "https://example.com/label/priority-order.pdf",
                "last_name": "Doe",
                "note": "Please deliver during business hours",
                "order_id": "ORD005",
                "payment_status": "pending",
                "phone": "+1-555-123-4567",
                "production_line_id": "8d9d7894-3908-4938-aa26-96f803c025ea",
                "production_status": "pending",
                "re_placed": false,
                "seller": "SELLER001",
                "shipping_fee": 6.9,
                "shipping_method": "standard",
                "state": "NY",
                "status": "new_order",
                "subtotal": 10.78,
                "tax": 0,
                "total": 17.68,
                "updated_at": "2025-08-20T16:04:42.675869",
                "user_id": "3f432ee6-2214-4732-a1ed-2462c38c76fa",
                "zip": "10001"
            },
            {
                "address_line_1": "123 Main Street",
                "address_line_2": "Suite 100",
                "box_fee": 0,
                "city": "New York",
                "country": "US",
                "created_at": "2025-08-20T15:58:59.782209",
                "created_by": "3f432ee6-2214-4732-a1ed-2462c38c76fa",
                "discount": 0,
                "email": "johndoe@example.com",
                "facility": "TX",
                "first_name": "John",
                "id": "092cc4a7-14c0-47de-8dae-55484d18d5cd",
                "items": [
                    {
                        "base_cost": 4.7,
                        "color": "ANTIQUE IRISH GREEN",
                        "inserts": [
                            {
                                "name": "packing_slip",
                                "size": "8.5x11",
                                "url": "https://example.com/packing_slip.pdf"
                            }
                        ],
                        "item_id": "KTK0TBIHKQZH7248QM9F5UHO",
                        "preview_files": [
                            {
                                "key": "mockup_front_url",
                                "url": "https://example.com/preview_file_1"
                            },
                            {
                                "key": "mockup_back_url",
                                "url": "https://example.com/preview_file_2"
                            }
                        ],
                        "print_files": [
                            {
                                "key": "front",
                                "print_tech": "dtf",
                                "url": "https://drive.google.com/file/d/1uN5z1dPiDUOW0ymN3F81iXeE5CIgfGt8/view?usp=drive_link"
                            }
                        ],
                        "product_name": "Unisex T-shirt | Gildan 5000",
                        "quantity": 2,
                        "size": "S",
                        "sku": "G05000AIG000S"
                    }
                ],
                "label_url": "https://example.com/label/priority-order.pdf",
                "last_name": "Doe",
                "note": "Please deliver during business hours",
                "order_id": "ORD003",
                "payment_status": "pending",
                "phone": "+1-555-123-4567",
                "production_line_id": "8d9d7894-3908-4938-aa26-96f803c025ea",
                "production_status": "pending",
                "re_placed": false,
                "seller": "SELLER001",
                "shipping_fee": 6.9,
                "shipping_method": "standard",
                "state": "NY",
                "status": "new_order",
                "subtotal": 10.78,
                "tax": 0,
                "total": 17.68,
                "updated_at": "2025-08-20T15:58:59.782209",
                "user_id": "3f432ee6-2214-4732-a1ed-2462c38c76fa",
                "zip": "10001"
            }
        ],
        "pagination": {
            "limit": 5,
            "page": 1,
            "pages": 2,
            "total": 7
        }
    },
    "message": "Orders retrieved successfully",
    "request_id": "d4c5623a-acf6-4b08-90d8-a22dcb11e536",
    "status": true,
    "timestamp": "2025-08-20T16:36:50.831035"
}

🟠422Validation Error

Modified at 2025-08-22 08:08:49

Create Order

Get Order Detail