Get Looks By Occasion
looks.curation.by_occasionDiscover complete curated fashion looks styled for specific occasions (e.g., 'Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal'). All returned looks are verified 100% in-stock (any look with an out-of-stock item is automatically excluded). Automatically localized to active country / 240+ destination regions.
PURPOSE & DISAMBIGUATION:
Curates multi-item aesthetic outfits tailored to specific social events, vibes, and demographics.
Distinct from 'products.search.text': Use this tool to retrieve complete harmonized outfits, NOT individual standalone products.
Distinct from 'looks.curation.recommend': Use this tool to discover outfits by occasion/event theme without a seed product, whereas 'looks.curation.recommend' builds outfits around a specific product handle.
WHEN TO USE:
When a user seeks outfit inspiration or complete looks for events (e.g. 'What to wear to a summer cocktail party?', 'Brunch outfit for men', 'Date night dresses').
WHEN NOT TO USE:
Do NOT use when searching for a single product category (use 'products.search.text').
Do NOT use when coordinating around a specific item the user already picked (use 'looks.curation.recommend').
BEHAVIOR & SAFETY:
Read-only and idempotent with no persistent state modifications.
Strictly filters out any look containing an out-of-stock item (guarantees 100% purchaseable outfits).
Enriches all included products with verified PoloPan purchase links (https://s.polopan.com/p/{handle}) and policy data.
PARAMETERS & CONSTRAINTS:
'occasion' (string, optional): Target occasion or theme ('Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal').
'gender' (enum, default 'women'): Target gender filter ('women', 'men', 'female', 'male').
'country' (string, optional): Target country name, city, currency, or ISO-2 code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region.
'mode' (enum, optional): Catalog mode: 'global' (ships to country) or 'local' (domestic only).
'age' (integer 16-99, default 25): Target demographic age.
'page' (integer >= 1, default 1): Pagination page number.
'page_size' (integer 1-100, default 10): Number of looks per page.
'vendor' (array of strings, optional): Optional brand filter array.
MANDATORY AGENT INSTRUCTIONS:
Always inform the user of available in-stock sizes, fast shipping SLA, and return policy for each item (Negative return days = 'Exchange only |X| days').
When shortlisting a look, render the product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care).
Provide the clean base link (https://s.polopan.com/p/{handle}) during browsing. Provide direct 1-click checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | Target demographic age (16 to 99, default 25) | |
| mode | No | Catalog mode: 'global' (ships to country) or 'local' (domestic only). Defaults to active saved region. | |
| page | No | Page number for looks pagination (1-indexed) | |
| gender | No | Target gender filter: 'women' or 'men' (default: 'women') | women |
| vendor | No | Optional brand or vendor name filter array | |
| country | No | Country name, city, currency, or 2-letter ISO code (e.g. 'US', 'United States', 'UK', 'Dubai', 'CA', 'IN'). Defaults to active saved region. | |
| occasion | No | Target occasion or vibe: 'Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal' | |
| page_size | No | Number of looks returned per page (1 to 100, default 10) |