{
    "openapi": "3.0.0",
    "info": {
        "title": "Mozillion Api",
        "description": "API documentation for Mozillion",
        "version": "0.1"
    },
    "paths": {
        "/api/listing": {
            "get": {
                "tags": [
                    "Listings"
                ],
                "summary": "Get seller product inventory listing",
                "description": "Fetches paginated product inventory for a logged-in seller (non-Mozillion seller). Requires valid client_id and access_token.",
                "operationId": "getListing",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "client_id",
                                    "access_token"
                                ],
                                "properties": {
                                    "client_id": {
                                        "description": "Client ID of the user",
                                        "type": "string",
                                        "example": "abc123"
                                    },
                                    "access_token": {
                                        "description": "Access token of the user",
                                        "type": "string",
                                        "example": "eyJhbGciOiJIUzI1..."
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": true
                                        },
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "properties": {
                                                    "product_id": {
                                                        "type": "integer",
                                                        "example": 123
                                                    },
                                                    "sku": {
                                                        "type": "string",
                                                        "example": "SKU123456"
                                                    },
                                                    "product_type": {
                                                        "type": "string",
                                                        "example": "Smartphone"
                                                    },
                                                    "product_category": {
                                                        "type": "string",
                                                        "example": "Mobile"
                                                    },
                                                    "product_title": {
                                                        "type": "string",
                                                        "example": "iPhone 13 Pro Max"
                                                    },
                                                    "ask_price": {
                                                        "type": "string",
                                                        "example": "699.00"
                                                    },
                                                    "quantity": {
                                                        "type": "integer",
                                                        "example": 2
                                                    }
                                                },
                                                "type": "object"
                                            }
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Seller product listing fetched successfully."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Validation Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Validation Error."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Unauthorized access."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Internal Server Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Something went wrong."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/listings/{sku}": {
            "get": {
                "tags": [
                    "Listings"
                ],
                "summary": "Get product listing by SKU",
                "description": "Fetch product listing by SKU using client_id and access_token in the request body.",
                "operationId": "getListingBySku",
                "parameters": [
                    {
                        "name": "sku",
                        "in": "path",
                        "description": "Product Inventory SKU",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "SKU_78945612_74859"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "client_id",
                                    "access_token"
                                ],
                                "properties": {
                                    "client_id": {
                                        "type": "string",
                                        "example": "eyJpdiI6InFmYzZlaitacjh1SkdmbzFsMDhScXc9PSIsInZhbHVlIjoi..."
                                    },
                                    "access_token": {
                                        "type": "string",
                                        "example": "tVQDW3chhWbFr3kSdqIE45Mqa5YjusBsVAImVs0n7Hd6wFkcv2"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Listing fetched successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "boolean",
                                            "example": true
                                        },
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "data": {
                                            "properties": {
                                                "product_id": {
                                                    "type": "integer",
                                                    "example": 5
                                                },
                                                "sku": {
                                                    "type": "string",
                                                    "example": "SKU_78945612_74859"
                                                },
                                                "product_type": {
                                                    "type": "string",
                                                    "example": "Phone"
                                                },
                                                "product_category": {
                                                    "type": "string",
                                                    "example": "Apple"
                                                },
                                                "product_title": {
                                                    "type": "string",
                                                    "example": "Apple iPhone 14 Midnight Black 128GB Good"
                                                },
                                                "ask_price": {
                                                    "type": "string",
                                                    "example": "250.00"
                                                },
                                                "quantity": {
                                                    "type": "integer",
                                                    "example": 15
                                                }
                                            },
                                            "type": "object"
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Seller's products listing fetched successfully."
                                        },
                                        "redirectUrl": {
                                            "type": "string",
                                            "example": null,
                                            "nullable": true
                                        },
                                        "isSuccess": {
                                            "type": "boolean",
                                            "example": true
                                        },
                                        "errorMessage": {
                                            "type": "string",
                                            "example": null,
                                            "nullable": true
                                        },
                                        "warningMessage": {
                                            "type": "string",
                                            "example": null,
                                            "nullable": true
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Listing not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "code": {
                                            "type": "integer",
                                            "example": 404
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "No matching listing found."
                                        },
                                        "isSuccess": {
                                            "type": "boolean",
                                            "example": false
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Listings"
                ],
                "summary": "Update specific listing by SKU",
                "description": "Update the ask price, quantity, or SKU for a specific listing. Requires client_id and access_token in the body for authentication.",
                "operationId": "updateListingBySku",
                "parameters": [
                    {
                        "name": "sku",
                        "in": "path",
                        "description": "Current SKU of the product listing",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "SKU_20250418_N0JTV"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "client_id",
                                    "access_token"
                                ],
                                "properties": {
                                    "client_id": {
                                        "type": "string",
                                        "example": "eyJpdiI6..."
                                    },
                                    "access_token": {
                                        "type": "string",
                                        "example": "tVQDW3chhWbFr3kSdqIE45Mqa5YjusBsVAImVs0n7Hd6wFkcv2"
                                    },
                                    "ask_price": {
                                        "type": "string",
                                        "example": "849.00"
                                    },
                                    "quantity": {
                                        "type": "integer",
                                        "example": 150
                                    },
                                    "sku": {
                                        "type": "string",
                                        "example": "SKU_20250418_N0JTV"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Listing updated successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "boolean",
                                            "example": true
                                        },
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "data": {
                                            "type": "array",
                                            "items": {}
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Seller's products listing updated successfully."
                                        },
                                        "redirectUrl": {
                                            "type": "string",
                                            "example": null,
                                            "nullable": true
                                        },
                                        "isSuccess": {
                                            "type": "boolean",
                                            "example": true
                                        },
                                        "errorMessage": {
                                            "type": "string",
                                            "example": null,
                                            "nullable": true
                                        },
                                        "warningMessage": {
                                            "type": "string",
                                            "example": null,
                                            "nullable": true
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Listing not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "code": {
                                            "type": "integer",
                                            "example": 404
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Listing not found for SKU: SKU_20250418_N0JTV"
                                        },
                                        "isSuccess": {
                                            "type": "boolean",
                                            "example": false
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized or Invalid Client Credentials",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "code": {
                                            "type": "integer",
                                            "example": 401
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Validation Error."
                                        },
                                        "isSuccess": {
                                            "type": "boolean",
                                            "example": false
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Internal server error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "code": {
                                            "type": "integer",
                                            "example": 500
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Something went wrong."
                                        },
                                        "isSuccess": {
                                            "type": "boolean",
                                            "example": false
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/update-listing": {
            "post": {
                "tags": [
                    "Listings"
                ],
                "summary": "Update product listings",
                "description": "Updates one or more product listings for a seller. Requires a valid client_id and access_token.",
                "operationId": "updateListing",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "client_id",
                                    "access_token",
                                    "listing_request_data"
                                ],
                                "properties": {
                                    "client_id": {
                                        "description": "Client ID of the user",
                                        "type": "string",
                                        "example": "eyJpdiI6InFmYzZlaitacjh1SkdmbzFsMDhScXc9PSIsInZhbHVlIjoi..."
                                    },
                                    "access_token": {
                                        "description": "Access token of the user",
                                        "type": "string",
                                        "example": "tVQDW3chhWbFr3kSdqIE45Mqa5YjusBsVAImVs0n7Hd6wFkcv2"
                                    },
                                    "listing_request_data": {
                                        "type": "array",
                                        "items": {
                                            "required": [
                                                "product_id",
                                                "ask_price",
                                                "quantity"
                                            ],
                                            "properties": {
                                                "product_id": {
                                                    "description": "Product ID",
                                                    "type": "integer",
                                                    "example": 644
                                                },
                                                "sku": {
                                                    "description": "SKU of the product",
                                                    "type": "string",
                                                    "example": "SKU_20250418_N0JTV"
                                                },
                                                "product_type": {
                                                    "description": "Type of the product",
                                                    "type": "string",
                                                    "example": "Phone"
                                                },
                                                "product_category": {
                                                    "description": "Category of the product",
                                                    "type": "string",
                                                    "example": "Apple"
                                                },
                                                "product_title": {
                                                    "description": "Title of the product",
                                                    "type": "string",
                                                    "example": "Apple iPhone 15 Midnight Black 128GB Good"
                                                },
                                                "ask_price": {
                                                    "description": "Price of the product",
                                                    "type": "string",
                                                    "example": "685.00"
                                                },
                                                "quantity": {
                                                    "description": "Available quantity",
                                                    "type": "integer",
                                                    "example": 100
                                                }
                                            },
                                            "type": "object"
                                        }
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Listings updated successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": true
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Listings updated successfully."
                                        },
                                        "data": {
                                            "properties": {
                                                "updated_product_ids": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "integer",
                                                        "example": 644
                                                    }
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Validation Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Validation Error."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Unauthorized access."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Listings not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "No matching listings found."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Internal Server Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Something went wrong."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/orders": {
            "get": {
                "tags": [
                    "Orders"
                ],
                "summary": "Get all orders for the logged-in seller",
                "description": "Fetch a paginated list of orders made to the seller’s products.",
                "operationId": "getOrderList",
                "parameters": [
                    {
                        "name": "client_id",
                        "in": "query",
                        "description": "User Client Id",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "access_token",
                        "in": "query",
                        "description": "User Access Token",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful fetch",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "properties": {
                                            "custom_order_id": {
                                                "type": "string"
                                            },
                                            "total_amount": {
                                                "type": "string"
                                            },
                                            "delivery_charge": {
                                                "type": "string"
                                            },
                                            "order_date": {
                                                "type": "string",
                                                "format": "date-time"
                                            },
                                            "shipping_address": {
                                                "properties": {
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "email": {
                                                        "type": "string"
                                                    },
                                                    "phone": {
                                                        "type": "string"
                                                    },
                                                    "address1": {
                                                        "type": "string"
                                                    },
                                                    "address2": {
                                                        "type": "string"
                                                    },
                                                    "city": {
                                                        "type": "string"
                                                    },
                                                    "state": {
                                                        "type": "string"
                                                    },
                                                    "country": {
                                                        "type": "string"
                                                    },
                                                    "zip_code": {
                                                        "type": "string"
                                                    }
                                                },
                                                "type": "object"
                                            },
                                            "items": {
                                                "type": "array",
                                                "items": {
                                                    "properties": {
                                                        "product_sku": {
                                                            "type": "string"
                                                        },
                                                        "product_name": {
                                                            "type": "string"
                                                        },
                                                        "product_price": {
                                                            "type": "string"
                                                        },
                                                        "quantity": {
                                                            "type": "integer"
                                                        },
                                                        "order_status": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "type": "object"
                                                }
                                            }
                                        },
                                        "type": "object"
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Validation Error"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "500": {
                        "description": "Internal Server Error"
                    }
                }
            }
        },
        "/api/orders/{custom_order_id}": {
            "get": {
                "tags": [
                    "Orders"
                ],
                "summary": "Get details of a specific order",
                "description": "Returns order details including products, price, and buyer shipping info.",
                "operationId": "getSpecificOrder",
                "parameters": [
                    {
                        "name": "custom_order_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "client_id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "access_token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Order found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "custom_order_id": {
                                            "type": "string"
                                        },
                                        "total_amount": {
                                            "type": "string"
                                        },
                                        "delivery_charge": {
                                            "type": "string"
                                        },
                                        "order_date": {
                                            "type": "string"
                                        },
                                        "shipping_address": {
                                            "properties": {
                                                "name": {
                                                    "type": "string"
                                                },
                                                "email": {
                                                    "type": "string"
                                                },
                                                "phone": {
                                                    "type": "string"
                                                },
                                                "address1": {
                                                    "type": "string"
                                                },
                                                "address2": {
                                                    "type": "string"
                                                },
                                                "city": {
                                                    "type": "string"
                                                },
                                                "state": {
                                                    "type": "string"
                                                },
                                                "country": {
                                                    "type": "string"
                                                },
                                                "zip_code": {
                                                    "type": "string"
                                                }
                                            },
                                            "type": "object"
                                        },
                                        "items": {
                                            "type": "array",
                                            "items": {
                                                "properties": {
                                                    "product_sku": {
                                                        "type": "string"
                                                    },
                                                    "product_name": {
                                                        "type": "string"
                                                    },
                                                    "product_price": {
                                                        "type": "string"
                                                    },
                                                    "quantity": {
                                                        "type": "integer"
                                                    },
                                                    "order_status": {
                                                        "type": "string"
                                                    }
                                                },
                                                "type": "object"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Validation Error"
                    },
                    "401": {
                        "description": "Unauthorized"
                    },
                    "500": {
                        "description": "Internal Server Error"
                    }
                }
            },
            "patch": {
                "tags": [
                    "Orders"
                ],
                "summary": "Update specific order by custom_order_id",
                "description": "Updates the order status and backend attributes (like IMEI) for a given order identified by custom_order_id. Requires client_id and access_token for authentication.",
                "operationId": "updateOrder",
                "parameters": [
                    {
                        "name": "custom_order_id",
                        "in": "path",
                        "description": "Custom order ID of the order to update",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "ORDER123456"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "client_id",
                                    "access_token",
                                    "order_request_data"
                                ],
                                "properties": {
                                    "client_id": {
                                        "type": "string",
                                        "example": "eyJpdiI6..."
                                    },
                                    "access_token": {
                                        "type": "string",
                                        "example": "tVQDW3chhWbFr3kSdqIE45Mqa5YjusBsVAImVs0n7Hd6wFkcv2"
                                    },
                                    "order_request_data": {
                                        "type": "array",
                                        "items": {
                                            "required": [
                                                "product_sku",
                                                "order_status"
                                            ],
                                            "properties": {
                                                "product_sku": {
                                                    "type": "string",
                                                    "example": "SKU_1234567890"
                                                },
                                                "order_status": {
                                                    "type": "string",
                                                    "example": "shipped"
                                                },
                                                "other_attribute": {
                                                    "description": "Optional attributes like IMEI or others depending on backend configuration",
                                                    "type": "object",
                                                    "example": {
                                                        "IMEI": "123456789012345"
                                                    }
                                                }
                                            },
                                            "type": "object"
                                        }
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Order updated successfully or a soft message like invalid status",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "boolean",
                                            "example": true
                                        },
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "data": {
                                            "type": "array",
                                            "items": {}
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Order updated successfully."
                                        },
                                        "isSuccess": {
                                            "type": "boolean",
                                            "example": true
                                        },
                                        "redirectUrl": {
                                            "type": "string",
                                            "example": null,
                                            "nullable": true
                                        },
                                        "errorMessage": {
                                            "type": "string",
                                            "example": null,
                                            "nullable": true
                                        },
                                        "warningMessage": {
                                            "type": "string",
                                            "example": null,
                                            "nullable": true
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Validation or input error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "code": {
                                            "type": "integer",
                                            "example": 400
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Validation Error."
                                        },
                                        "isSuccess": {
                                            "type": "boolean",
                                            "example": false
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized - invalid client credentials",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "code": {
                                            "type": "integer",
                                            "example": 401
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Unauthorized access."
                                        },
                                        "isSuccess": {
                                            "type": "boolean",
                                            "example": false
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/product-offers-list": {
            "post": {
                "tags": [
                    "Offers"
                ],
                "summary": "Get product offer list",
                "description": "Fetches a paginated list of product offers for the logged-in seller (non-Mozillion seller). Requires valid client_id and access_token.",
                "operationId": "getProductOfferList",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "client_id",
                                    "access_token"
                                ],
                                "properties": {
                                    "client_id": {
                                        "description": "Client ID of the user",
                                        "type": "string",
                                        "example": "abc123"
                                    },
                                    "access_token": {
                                        "description": "Access token of the user",
                                        "type": "string",
                                        "example": "eyJhbGciOiJIUzI1..."
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": true
                                        },
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "properties": {
                                                    "product_id": {
                                                        "type": "integer",
                                                        "example": 123
                                                    },
                                                    "inventory_id": {
                                                        "type": "integer",
                                                        "example": 521
                                                    },
                                                    "sku": {
                                                        "type": "string",
                                                        "example": "SKU123456"
                                                    },
                                                    "product_type": {
                                                        "type": "string",
                                                        "example": "Smartphone"
                                                    },
                                                    "product_category": {
                                                        "type": "string",
                                                        "example": "Mobile"
                                                    },
                                                    "product_title": {
                                                        "type": "string",
                                                        "example": "iPhone 13 Pro Max"
                                                    },
                                                    "product_modal": {
                                                        "type": "string",
                                                        "example": "iPhone 13 Pro Max"
                                                    },
                                                    "buyer_offer_price": {
                                                        "type": "string",
                                                        "example": "699.00"
                                                    }
                                                },
                                                "type": "object"
                                            }
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Product offer fetched successfully."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Validation Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Validation Error."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Unauthorized access."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Internal Server Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Something went wrong."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/api/product-offers-update": {
            "post": {
                "tags": [
                    "Offers"
                ],
                "summary": "Update product offers",
                "description": "Updates one or more product offers for a seller. Requires a valid client_id and access_token.",
                "operationId": "updateProductOffer",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "client_id",
                                    "access_token",
                                    "offer_request_data"
                                ],
                                "properties": {
                                    "client_id": {
                                        "description": "Client ID of the user",
                                        "type": "string",
                                        "example": "eyJpdiI6InFmYzZlaitacjh1SkdmbzFsMDhScXc9PSIsInZhbHVlIjoi..."
                                    },
                                    "access_token": {
                                        "description": "Access token of the user",
                                        "type": "string",
                                        "example": "tVQDW3chhWbFr3kSdqIE45Mqa5YjusBsVAImVs0n7Hd6wFkcv2"
                                    },
                                    "offer_request_data": {
                                        "type": "array",
                                        "items": {
                                            "required": [
                                                "sku",
                                                "buyer_offer_price"
                                            ],
                                            "properties": {
                                                "product_id": {
                                                    "description": "Product ID",
                                                    "type": "integer",
                                                    "example": 644
                                                },
                                                "sku": {
                                                    "description": "SKU of the product",
                                                    "type": "string",
                                                    "example": "SKU_20250418_N0JTV"
                                                },
                                                "inventory_id": {
                                                    "type": "integer",
                                                    "example": 521
                                                },
                                                "product_type": {
                                                    "type": "string",
                                                    "example": "Smartphone"
                                                },
                                                "product_category": {
                                                    "type": "string",
                                                    "example": "Mobile"
                                                },
                                                "product_title": {
                                                    "type": "string",
                                                    "example": "iPhone 13 Pro Max"
                                                },
                                                "product_modal": {
                                                    "type": "string",
                                                    "example": "iPhone 13 Pro Max"
                                                },
                                                "buyer_offer_price": {
                                                    "description": "Price of the product",
                                                    "type": "string",
                                                    "example": "685.00"
                                                }
                                            },
                                            "type": "object"
                                        }
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Offers updated successfully",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": true
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Offers updated successfully."
                                        },
                                        "data": {
                                            "properties": {
                                                "updated_product_ids": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "integer",
                                                        "example": 644
                                                    }
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Validation Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Validation Error."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Unauthorized access."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Offers not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "No matching offers found."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Internal Server Error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "success": {
                                            "type": "boolean",
                                            "example": false
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Something went wrong."
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "tags": [
        {
            "name": "Listings",
            "description": "Listings"
        },
        {
            "name": "Orders",
            "description": "Orders"
        },
        {
            "name": "Offers",
            "description": "Offers"
        }
    ]
}