API Documentation

<?php
$YOUR_API_KEY_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => "https://lebha.com/api/v1/open/fetchCategories",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "Authorization: Bearer " . $YOUR_API_KEY_TOKEN
    ]
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($response, true);

if ($httpCode === 200) {
    echo "Success! Categories retrieved.\n";
    print_r($data['data']);
} else {
    echo "Error: " . $data['message'] . "\n";
}
?>

<?php
$url = 'https://lebha.com/api/v1/open/fetchSubCategoryByCategoryId';
$YOUR_API_KEY_TOKEN = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';

$data = [
    'category_id' => 5
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $YOUR_API_KEY_TOKEN
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);

if ($httpCode === 200 && $result['status']) {
    echo "Success! Found " . count($result['data']) . " subcategories\n";
    foreach ($result['data'] as $subcategory) {
        echo "- {$subcategory['name']} (ID: {$subcategory['id']})\n";
    }
} else {
    echo "Error: {$result['message']}\n";
    echo "Error Code: {$result['error_code']}\n";
}
?>

{
"status": true,
"data": [
    {
        "id": "24",
        "category_id": "4",
        "name": "Kitchen Accessories",
        "img": "https://lebha.com/uploads/subcategory/thump_1756368381.webp"
    },
    {
        "id": "95",
        "category_id": "4",
        "name": "Nonstick",
        "img": "https://lebha.com/uploads/subcategory/subcat_1756375609.webp"
    },
    {
        "id": "96",
        "category_id": "4",
        "name": "Glass Items",
        "img": "https://lebha.com/uploads/subcategory/subcat_1756375952.webp"
    },
    {
        "id": "97",
        "category_id": "4",
        "name": "Steel Items",
        "img": "https://lebha.com/uploads/subcategory/subcat_1756376134.webp"
    }
],
"message": "Subcategories retrieved successfully"
}

{
    "status": false,
    "error_code": "MISSING_REQUEST_DATA",
    "message": "Request body is required"
}

{
    "status": false,
    "error_code": "CATEGORY_ID_REQUIRED",
    "message": "category_id is required in request body"
}

{
    "status": false,
    "error_code": "INVALID_CATEGORY_ID",
    "message": "category_id must be a positive integer"
}

{
    "status": false,
    "error_code": "INVALID_JSON_INPUT",
    "message": "Invalid JSON input provided"
}

{
    "status": false,
    "error_code": "INVALID_TOKEN_PAYLOAD",
    "message": "Invalid token payload: email missing"
}

{
    "status": false,
    "error_code": "USER_NOT_FOUND",
    "message": "User not found or account is inactive"
}

{
    "status": false,
    "error_code": "TOKEN_VALIDATION_FAILED",
    "message": "Token validation failed: "
}

{
    "status": false,
    "error_code": "INVALID_AUTH_FORMAT",
    "message": "Authorization header must be in format: Bearer "
}

{
    "status": false,
    "error_code": "CATEGORY_NOT_FOUND",
    "message": "Category with ID 999 not found"
}

{
    "status": false,
    "error_code": "DATABASE_QUERY_FAILED",
    "message": "Failed to fetch subcategories from database",
    "debug_message": "Error details (only in development mode)"
}

{
    "status": false,
    "error_code": "SETTINGS_NOT_LOADED",
    "message": "Application settings not properly loaded"
}

<?php
$url = 'https://lebha.com/api/v1/open/fetchBrands';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);

if ($httpCode === 200 && $result['status']) {
    echo "Success! Found " . count($result['data']) . " brands\n";
    foreach ($result['data'] as $brand) {
        echo "- {$brand['brand']} (ID: {$brand['id']})\n";
        echo "  Image: {$brand['image']}\n";
    }
} else {
    echo "Error: {$result['message']}\n";
    if (isset($result['error_code'])) {
        echo "Error Code: {$result['error_code']}\n";
    }
}
?>

  <?php

  // API Configuration
  $apiUrl = 'https://lebha.com/api/v1/open/placeOrder';
  $bearerToken = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'; // Your JWT token
  
  // Prepare order data
  $orderData = [
      'my_order_id' => 'ORD-2024-001',
      'customer_name' => 'John Doe',
      'customer_email' => 'john.doe@example.com',
      'customer_mobile' => '+919876543210',
      'customer_address' => '123 Main Street',
      'customer_flat' => '4B',
      'customer_floor' => '4th Floor',
      'customer_landmark' => 'Near City Mall',
      'customer_city' => 'Mumbai',
      'customer_state' => 'Maharashtra',
      'customer_pincode' => '400001',
      'customer_latitude' => 19.0760,
      'customer_longitude' => 72.8777,
      'customer_map_address' => '123 Main Street, Near City Mall, Mumbai, Maharashtra 400001',
      'delivery_date' => '2025-10-05 14:00:00',
      'note' => 'Please call before delivery',
      'payment_method' => 'COD',
      'products' => [
          [
              'product_id' => 101,
              'product_variants_id' => 5,
              'quantity' => 2,
              'price' => 599.99
          ],
          [
              'product_id' => 102,
              'product_variants_id' => 8,
              'quantity' => 1,
              'price' => 1299.00
          ]
      ]
  ];
  
  // Initialize cURL
  $ch = curl_init($apiUrl);
  
  // Set cURL options
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_POST, true);
  curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($orderData));
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'Content-Type: application/json',
      'Authorization: Bearer ' . $bearerToken
  ]);
  
  // Execute request
  $response = curl_exec($ch);
  $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
  
  // Check for errors
  if (curl_errno($ch)) {
      echo 'cURL Error: ' . curl_error($ch);
      curl_close($ch);
      exit;
  }
  
  curl_close($ch);
  
  // Decode and display response
  $responseData = json_decode($response, true);
  
  echo "HTTP Status Code: " . $httpCode . "\n";
  echo "Response:\n";
  print_r($responseData);
  
  // Handle response based on status code
  if ($httpCode === 201) {
      echo "\nOrder placed successfully!\n";
      echo "Order ID: " . $responseData['data']['order_id'] . "\n";
      echo "Total Amount: ₹" . $responseData['data']['total_amount'] . "\n";
  } else {
      echo "\nOrder placement failed!\n";
      echo "Error: " . $responseData['message'] . "\n";
  }
  
  ?>

<?php
$url = 'https://lebha.com/api/v1/open/fetchOrderList';
$YOUR_API_KEY_TOKEN = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';

$data = [
    'page' => 1,
    'limit' => 10
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $YOUR_API_KEY_TOKEN,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);

if ($httpCode === 200 && $result['status']) {
    echo "Total Orders: " . $result['data']['pagination']['total_orders'] . "\n";
    foreach ($result['data']['orders'] as $order) {
        echo "Order ID: " . $order['my_order_id'] . " - Amount: ₹" . $order['order_summary']['total_amount'] . "\n";
    }
} else {
    echo "Error: " . ($result['message'] ?? 'Unknown error') . "\n";
}
?>

<?php

// API Configuration
$apiUrl = 'https://lebha.com/api/v1/open/fetchOrderDetails';
$YOUR_API_KEY_TOKEN = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'; // Your JWT token
$orderId = 12345;

// Prepare request data
$requestData = [
    'order_id' => $orderId
];

// Initialize cURL
$ch = curl_init($apiUrl);

// Set cURL options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($requestData));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $YOUR_API_KEY_TOKEN
]);

// Execute request
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

// Check for errors
if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
    curl_close($ch);
    exit;
}

curl_close($ch);

// Decode and display response
$responseData = json_decode($response, true);

echo "HTTP Status Code: " . $httpCode . "\n";
echo "\nOrder Details:\n";
print_r($responseData);

// Handle response
if ($httpCode === 200 && isset($responseData['data'])) {
    $order = $responseData['data']['order_details'];
    $customer = $responseData['data']['customer_details'];
    $payment = $responseData['data']['payment_details'];
    
    echo "\n=== ORDER SUMMARY ===\n";
    echo "Order ID: " . $order['my_order_id'] . "\n";
    echo "Customer: " . $customer['name'] . "\n";
    echo "Total Amount: ₹" . $payment['total_amount'] . "\n";
    echo "Payment Method: " . $payment['payment_method'] . "\n";
    echo "Status: " . $order['status'] . "\n";
} else {
    echo "\nFailed to fetch order details!\n";
    if (isset($responseData['message'])) {
        echo "Error: " . $responseData['message'] . "\n";
    }
}

?>

<?php

// API Configuration
$apiUrl = 'https://lebha.com/api/v1/open/cancelOrder';
$bearerToken = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'; // Your JWT token
$orderId = 12345;

// Prepare cancellation data
$cancelData = [
    'order_id' => $orderId
];

// Initialize cURL
$ch = curl_init($apiUrl);

// Set cURL options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($cancelData));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $bearerToken
]);

// Execute request
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

// Check for errors
if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
    curl_close($ch);
    exit;
}

curl_close($ch);

// Decode and display response
$responseData = json_decode($response, true);

echo "HTTP Status Code: " . $httpCode . "\n";
echo "Response:\n";
print_r($responseData);

// Handle response based on status code
if ($httpCode === 200) {
    echo "\n" . $responseData['message'] . "\n";
} else {
    echo "\nCancellation failed!\n";
    echo "Error: " . $responseData['message'] . "\n";
}

?>

<?php

$url = 'https://lebha.com/api/v1/open/trackingOrder';
$YOUR_API_KEY_TOKEN = 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...';

$data = [
    'order_id' => 12345
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $YOUR_API_KEY_TOKEN
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);

if ($result['status']) {
    echo "Tracking Information Retrieved Successfully!\n\n";
    
    foreach ($result['data']['orders'] as $order) {
        echo "Order ID: " . $order['entrepreneur_orders_id'] . "\n";
        echo "Shiprocket Order ID: " . $order['shiprocket_order_id'] . "\n";
        echo "AWB Code: " . $order['awb_code'] . "\n";
        echo "Courier: " . $order['courier_name'] . "\n";
        echo "Status: " . $order['order_status'] . "\n";
        echo "Tracking URL: " . $order['tracking_url'] . "\n";
        echo "Cancelled: " . ($order['is_shipment_cancelled'] ? 'Yes' : 'No') . "\n";
        
        if (!empty($order['pickup_details'])) {
            echo "\nPickup Details:\n";
            echo "  Status: " . $order['pickup_details']['pickup_status'] . "\n";
            echo "  Scheduled Date: " . $order['pickup_details']['pickup_scheduled_date'] . "\n";
            echo "  Token: " . $order['pickup_details']['pickup_token_number'] . "\n";
        }
        
        if (!empty($order['documents'])) {
            echo "\nDocuments:\n";
            foreach ($order['documents'] as $docType => $docUrl) {
                echo "  " . ucfirst(str_replace('_', ' ', $docType)) . ": " . $docUrl . "\n";
            }
        }
        
        echo "\n" . str_repeat('-', 50) . "\n\n";
    }
} else {
    echo "Error: " . $result['message'] . "\n";
    if (isset($result['error_code'])) {
        echo "Error Code: " . $result['error_code'] . "\n";
    }
}
?>
                    

{
    "status": true,
    "message": "Orders retrieved successfully",
    "data": {
        "total_orders": 1,
        "orders": [
            {
                "id": 1,
                "entrepreneur_orders_id": 12345,
                "is_shipment_cancelled": false,
                "shiprocket_order_id": "SR123456789",
                "shiprocket_shipment_id": "12345678",
                "shiprocket_awb_code": "AWB123456789",
                "seller_id": 10,
                "tracking_url": "https://shiprocket.co/tracking/AWB123456789",
                "order_status": "PICKUP_SCHEDULED",
                "courier_name": "Delhivery",
                "awb_code": "AWB123456789",
                "freight_charges": 45.50,
                "applied_weight": 0.5,
                "documents": {
                    "manifest_url": "https://shipments.shiprocket.in/manifest/manifest_12345.pdf",
                    "label_url": "https://shipments.shiprocket.in/label/label_12345.pdf",
                    "invoice_url": "https://shipments.shiprocket.in/invoice/invoice_12345.pdf",
                    "print_manifest_url": "https://shipments.shiprocket.in/manifest/print_12345.pdf"
                },
                "pickup_details": {
                    "pickup_status": "scheduled",
                    "pickup_scheduled_date": "2025-09-30 14:00:00",
                    "pickup_token_number": "PKP123456",
                    "pickup_message": "Pickup has been scheduled successfully"
                },
                "tracking_details": {
                    "tracking_data": {
                        "track_status": 1,
                        "shipment_status": "In Transit",
                        "shipment_track": [
                            {
                                "id": 1,
                                "awb_code": "AWB123456789",
                                "courier_company_id": 1,
                                "shipment_status": "Picked Up",
                                "current_status": "Picked Up",
                                "activities": [
                                    {
                                        "date": "2025-09-30 15:30:00",
                                        "status": "Picked Up",
                                        "activity": "Shipment picked up from origin",
                                        "location": "Mumbai, Maharashtra"
                                    },
                                    {
                                        "date": "2025-09-30 18:45:00",
                                        "status": "In Transit",
                                        "activity": "Shipment in transit",
                                        "location": "Delhi Hub"
                                    }
                                ]
                            }
                        ]
                    }
                }
            }
        ]
    }
}

{
    "status": false,
    "error_code": "NO_ORDERS_FOUND",
    "message": "No shiprocket orders found matching the criteria"
}

{
    "status": false,
    "error_code": "INVALID_JSON_INPUT",
    "message": "Valid JSON input is required in request body"
}

{
    "status": false,
    "error_code": "INVALID_AUTH_FORMAT",
    "message": "Authorization header must be in format: Bearer "
}

{
    "status": false,
    "error_code": "TOKEN_VALIDATION_FAILED",
    "message": "Token validation failed: [error details]"
}

{
    "status": false,
    "error_code": "USER_NOT_FOUND",
    "message": "User not found or account is inactive"
}

{
    "status": false,
    "error_code": "MODEL_INITIALIZATION_FAILED",
    "message": "Failed to initialize shiprocket Order Details"
}

{
    "status": false,
    "error_code": "UNEXPECTED_ERROR",
    "message": "An unexpected error occurred",
    "debug_message": "Error details (only in development mode)"
}