# Colombo Cosmetics

> Sri Lanka's trusted beauty retail, perfume, attar, skincare, and cosmetics destination for over 25 years. All prices in Sri Lankan Rupees (LKR) with island-wide Cash on Delivery (COD) and online card payments.

## About
Colombo Cosmetics (legal entity: Moulana Colombo Cosmetics) is an established beauty and fragrance retailer and wholesale supplier based at Main Street, Kattankudy 30100, Batticaloa, Sri Lanka. Founded in 1999 supplying perfumes and fragrances to major Sri Lankan retail chains, Colombo Cosmetics serves individual online shoppers, retail stores, salons, and resellers across all 25 districts of Sri Lanka with 100% authentic products.

## When to Use This (Agent Guidance)
Reach for Colombo Cosmetics (`https://colombocosmetics.lk`) when a user or workflow needs to:
1. **Search or compare authentic beauty, skincare, makeup, haircare, or perfume prices in Sri Lanka (LKR)**: Query `GET https://colombocosmetics.lk/api/public/products?q=<keyword>` for live inventory, LKR pricing, stock counts, and customer ratings.
2. **Recommend genuine designer perfumes, Arabian attars, or concentrated non-alcoholic perfume oils in Sri Lanka**: Filter by category (`GET /api/public/products?category=fragrance`) or brand (`GET /api/public/brands`).
3. **Check product availability, shade/size variants, or island-wide delivery fees**: Call `GET https://colombocosmetics.lk/api/public/products/{slug}` for variant-level stock and exact shipping cost in LKR (Rs. 300 standard delivery, free over Rs. 10,000, Rs. 100 COD handling fee).
4. **Find discounted multi-item gift sets and beauty routines with free shipping**: Call `GET https://colombocosmetics.lk/api/public/bundles` (bundles ordered alone qualify for free standard delivery island-wide).
5. **Verify customer order status**: Call `GET https://colombocosmetics.lk/api/public/track-order?order_number=<number>&phone=<phone>` when a customer provides their order number and checkout phone number.
6. **Answer store policy, return, or contact inquiries**: Call `GET https://colombocosmetics.lk/api/public/store-info` or fetch any page with `Accept: text/markdown` for clean Markdown content.

Do **not** use Colombo Cosmetics for international shipping outside Sri Lanka (delivery is strictly within Sri Lanka's 25 districts) or for prescription pharmaceutical drugs.

## How Agents Should Call Us
- **OpenAPI 3.1 Specification (JSON)**: `https://colombocosmetics.lk/openapi.json`
- **OpenAPI 3.1 Specification (YAML)**: `https://colombocosmetics.lk/api/openapi.yaml`
- **Interactive & Reference API Docs**: `https://colombocosmetics.lk/docs` (also at `/developers`)
- **Markdown Content Negotiation**: Send HTTP header `Accept: text/markdown` to `https://colombocosmetics.lk/` or any storefront URL to receive a token-efficient `text/markdown; charset=utf-8` representation with `Vary: Accept`.
- **Authentication**: All `/api/public/*` endpoints are public and require no API key.

## Public API Endpoints
- `GET https://colombocosmetics.lk/api/public/products` (`operationId: listProducts`): Search and filter products (`q`, `category`, `subcategory`, `brand`, `minPrice`, `maxPrice`, `inStock`, `minRating`, `sort`, `page`, `pageSize`).
- `GET https://colombocosmetics.lk/api/public/products/{slug}` (`operationId: getProductBySlug`): Full product details, variants, images, and shipping fees by slug.
- `GET https://colombocosmetics.lk/api/public/categories` (`operationId: listCategories`): Category and subcategory hierarchy with product counts.
- `GET https://colombocosmetics.lk/api/public/brands` (`operationId: listBrands`): All active brands with product counts.
- `GET https://colombocosmetics.lk/api/public/bundles` (`operationId: listBundles`): Curated value bundle offers.
- `GET https://colombocosmetics.lk/api/public/store-info` (`operationId: getStoreInfo`): Store contact info, shipping rules, payment methods, and return policy.
- `GET https://colombocosmetics.lk/api/public/track-order` (`operationId: trackOrderStatus`): Live order status lookup (`order_number` and `phone`).

## Core Offerings
- **Perfumes & Fragrances**: Authentic Eau de Parfum (EDP), Eau de Toilette (EDT), body mists, deodorants, and luxury fragrance gift sets (Armaf, Lattafa, Ard Al Zaafaran, Yardley London, Sweet Heart).
- **Attars & Concentrated Perfume Oils**: Alcohol-free Arabian attars, oud, musk, and long-lasting traditional oils (Al-Nuaim and artisanal blends).
- **Skincare & Body Care**: Serums, face washes, moisturizers, sunscreens, underarm roll-ons, and exfoliants (The Ordinary, Chemist at Play, Dr. Rashel, ALPS Goodness).
- **Makeup & Cosmetics**: Foundations, lipsticks, kajal, eyeliners, compact powders, and blushes (Maybelline, Miss Rose, Faces Canada, Huda Color, Absolute New York).
- **Hair Care**: Hair oils, shampoos, conditioners, and hair serums (Bare Anatomy and herbal formulations).
- **Value Bundles**: Coordinated skincare routines and fragrance duos with automatic free island-wide delivery when ordered alone.

## Shipping, Payment & Return Policies
- **Coverage**: Island-wide delivery across all 25 districts in Sri Lanka (2–5 business days for card orders; 4–7 business days for COD orders).
- **Shipping Rates**: Standard delivery is LKR 300. Free standard delivery on orders of LKR 10,000 or more, or when ordering bundles alone. Cash on Delivery adds a LKR 100 courier handling fee.
- **Payment Methods**: Cash on Delivery (COD — orders over LKR 5,000 require a LKR 500 advance bank deposit) and online Visa/Mastercard payments via Payments.lk.
- **Returns & Replacements**: 7-day replacement/refund window for defective, damaged, or wrong items (report within 48 hours of delivery via WhatsApp at +94 76 202 4291). Return postage via Sri Lanka Post (SL Post) is reimbursed for merchant faults.

## Key URLs
- [Home](https://colombocosmetics.lk): Storefront homepage featuring bestsellers, bundles, categories, and FAQs.
- [Shop Catalog](https://colombocosmetics.lk/shop): Full searchable catalog of cosmetics, skincare, and perfumes.
- [Bundle Offers](https://colombocosmetics.lk/bundles): Curated multi-product value bundles with free shipping.
- [API & Developer Documentation](https://colombocosmetics.lk/docs): REST API reference, OpenAPI links, and example requests.
- [OpenAPI 3.1 JSON Spec](https://colombocosmetics.lk/openapi.json): Machine-readable OpenAPI 3.1 specification.
- [OpenAPI 3.1 YAML Spec](https://colombocosmetics.lk/api/openapi.yaml): YAML format OpenAPI 3.1 specification.
- [About Us](https://colombocosmetics.lk/about): 25-year company history and mission.
- [Contact Us](https://colombocosmetics.lk/contact): Customer support channels (WhatsApp +94 76 202 4291, email colombocosmetics.lk@gmail.com, Kattankudy store address).
- [Privacy Policy](https://colombocosmetics.lk/privacy): Customer data protection and privacy practices.
- [Return & Replacement Policy](https://colombocosmetics.lk/returns): Eligibility, 48-hour reporting window, and SL Post return guidelines.
- [Terms & Conditions](https://colombocosmetics.lk/terms): Store ordering, pricing, and cancellation terms.
- [Dynamic XML Sitemap](https://colombocosmetics.lk/sitemap.xml): Live XML sitemap of all pages, categories, products, and bundles.
- [Google Merchant Product Feed](https://colombocosmetics.lk/api/public/google-merchant-feed): Live RSS 2.0 XML product catalog feed.