# Get first page of orders with default pagination
curl -X GET "{{host}}/api/v1/orders" \
  -H "Authorization: Bearer your_access_token"

# Filter by delivered status with custom pagination
curl -X GET "{{host}}/api/v1/orders?status=delivered&limit=20&page=1" \
  -H "Authorization: Bearer your_access_token"

# Get orders for specific product
curl -X GET "{{host}}/api/v1/orders?product_id=1001" \
  -H "Authorization: Bearer your_access_token"

# Combine filters
curl -X GET "{{host}}/api/v1/orders?status=delivered&product_id=1001&limit=50" \
  -H "Authorization: Bearer your_access_token"

<?php
// Function to list orders with pagination
function listOrders($api, $filters = []) {
    $defaultFilters = [
        'page' => 1,
        'limit' => 10
    ];
    
    $params = array_merge($defaultFilters, $filters);
    $queryString = http_build_query($params);
    
    $response = $api->makeAuthenticatedRequest(
        "{{host}}/api/v1/orders?{$queryString}"
    );
    
    // Access pagination info from headers
    $headers = $api->getLastResponseHeaders();
    $pagination = [
        'current_page' => $headers['X-Page'] ?? 1,
        'per_page' => $headers['X-Per-Page'] ?? 10,
        'total_count' => $headers['X-Total-Count'] ?? 0,
        'total_pages' => $headers['X-Total-Pages'] ?? 1
    ];
    
    return [
        'orders' => $response,
        'pagination' => $pagination
    ];
}

// Example: Get recent delivered orders
$result = listOrders($api, [
    'status' => 'delivered',
    'limit' => 20,
    'page' => 1
]);

foreach ($result['orders'] as $order) {
    echo "Order #{$order['id']}: {$order['product_name']}\n";
    echo "  Amount: {$order['currency']} {$order['amount']}\n";
    echo "  Status: {$order['status']}\n";
    echo "  Date: " . date('Y-m-d H:i', strtotime($order['placed_at'])) . "\n\n";
}

// Display pagination info
echo "Page {$result['pagination']['current_page']} of {$result['pagination']['total_pages']}\n";
echo "Total orders: {$result['pagination']['total_count']}\n";

// Example: Build order history table
function displayOrderTable($api, $page = 1, $status = null) {
    $filters = ['page' => $page, 'limit' => 25];
    if ($status) {
        $filters['status'] = $status;
    }
    
    $result = listOrders($api, $filters);
    
    echo "<table class='orders-table'>\n";
    echo "  <thead>\n";
    echo "    <tr>\n";
    echo "      <th>Order ID</th>\n";
    echo "      <th>Reference</th>\n";
    echo "      <th>Product</th>\n";
    echo "      <th>Amount</th>\n";
    echo "      <th>Status</th>\n";
    echo "      <th>Customer</th>\n";
    echo "      <th>Date</th>\n";
    echo "      <th>Actions</th>\n";
    echo "    </tr>\n";
    echo "  </thead>\n";
    echo "  <tbody>\n";
    
    foreach ($result['orders'] as $order) {
        $statusClass = 'status-' . strtolower($order['status']);
        $date = date('M d, Y H:i', strtotime($order['placed_at']));
        
        echo "    <tr>\n";
        echo "      <td>#{$order['id']}</td>\n";
        echo "      <td>{$order['reference_code']}</td>\n";
        echo "      <td>{$order['product_name']}</td>\n";
        echo "      <td>{$order['currency']} {$order['amount']}</td>\n";
        echo "      <td><span class='{$statusClass}'>{$order['status']}</span></td>\n";
        echo "      <td>" . ($order['email'] ?? 'N/A') . "</td>\n";
        echo "      <td>{$date}</td>\n";
        echo "      <td>\n";
        echo "        <a href='/orders/{$order['id']}' class='btn-view'>View</a>\n";
        echo "      </td>\n";
        echo "    </tr>\n";
    }
    
    echo "  </tbody>\n";
    echo "</table>\n";
    
    // Pagination controls
    $pagination = $result['pagination'];
    if ($pagination['total_pages'] > 1) {
        echo "<div class='pagination'>\n";
        
        // Previous button
        if ($pagination['current_page'] > 1) {
            $prevPage = $pagination['current_page'] - 1;
            echo "  <a href='?page={$prevPage}' class='btn-prev'>Previous</a>\n";
        }
        
        // Page numbers
        echo "  <span>Page {$pagination['current_page']} of {$pagination['total_pages']}</span>\n";
        
        // Next button
        if ($pagination['current_page'] < $pagination['total_pages']) {
            $nextPage = $pagination['current_page'] + 1;
            echo "  <a href='?page={$nextPage}' class='btn-next'>Next</a>\n";
        }
        
        echo "</div>\n";
    }
}

// Display the table
displayOrderTable($api, $_GET['page'] ?? 1, $_GET['status'] ?? null);
?>