{"openapi":"3.1.0","info":{"title":"Mondoir API","description":"API for Mondoir, a global contemporary art platform that sells original artworks online and accepts artist submissions worldwide. Browse and buy paintings, sculptures, photography, and prints from emerging and established artists. Check exhibitions, explore art services (valuation, sourcing, consulting), and learn about the Partner Studio consignment program for artists.","version":"1.0.0","contact":{"name":"Mondoir Gallery","email":"gm@mondoir.art","url":"https://mondoir.art"}},"servers":[{"url":"https://mondoir.art","description":"Mondoir Production Server"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/api/gpt/info":{"get":{"operationId":"getGalleryInfo","summary":"Get comprehensive Mondoir information","description":"Returns detailed information about Mondoir including services, global programs, contact details, gallery location, opening hours, and the Partner Studio program.","responses":{"200":{"description":"Gallery information retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryInfo"}}}}}}},"/api/gpt/artworks":{"get":{"operationId":"searchArtworks","summary":"Search and browse available artworks","description":"Returns artworks available for sale from artists worldwide. Can filter by type, medium, style, price range, and artist. Ships internationally.","parameters":[{"name":"type","in":"query","description":"Filter by artwork type (e.g., painting, sculpture, photography, print, digital)","schema":{"type":"string"},"required":false},{"name":"medium","in":"query","description":"Filter by medium (e.g., oil, acrylic, bronze, photograph)","schema":{"type":"string"},"required":false},{"name":"style","in":"query","description":"Filter by style (e.g., abstract, contemporary, figurative, minimalist)","schema":{"type":"string"},"required":false},{"name":"minPrice","in":"query","description":"Minimum price in USD","schema":{"type":"integer"},"required":false},{"name":"maxPrice","in":"query","description":"Maximum price in USD","schema":{"type":"integer"},"required":false},{"name":"limit","in":"query","description":"Maximum number of results (default 10, max 50)","schema":{"type":"integer","default":10,"maximum":50},"required":false}],"responses":{"200":{"description":"List of artworks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtworkList"}}}}}}},"/api/gpt/artists":{"get":{"operationId":"getArtists","summary":"Get list of artists","description":"Returns artists represented on Mondoir from around the world, including gallery-represented and Partner Studio artists.","parameters":[{"name":"studio","in":"query","description":"If true, returns only Partner Studio artists","schema":{"type":"boolean"},"required":false},{"name":"country","in":"query","description":"Filter by artist nationality/country","schema":{"type":"string"},"required":false},{"name":"limit","in":"query","description":"Maximum number of results (default 20, max 100)","schema":{"type":"integer","default":20,"maximum":100},"required":false}],"responses":{"200":{"description":"List of artists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtistList"}}}}}}},"/api/gpt/events":{"get":{"operationId":"getEvents","summary":"Get events and exhibitions","description":"Returns current and upcoming exhibitions, openings, and events at Mondoir Gallery.","parameters":[{"name":"upcoming","in":"query","description":"If true, returns only future events","schema":{"type":"boolean","default":true},"required":false},{"name":"limit","in":"query","description":"Maximum number of results (default 10)","schema":{"type":"integer","default":10},"required":false}],"responses":{"200":{"description":"List of events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventList"}}}}}}},"/api/gpt/partner-studio":{"get":{"operationId":"getPartnerStudioInfo","summary":"Get Partner Studio program details","description":"Returns comprehensive information about Mondoir's Partner Studio consignment program for artists, including benefits, commission structure, and how to apply.","responses":{"200":{"description":"Partner Studio program information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerStudioInfo"}}}}}}},"/api/gpt/galleries":{"get":{"operationId":"searchUAEGalleries","summary":"Search UAE art galleries and cultural venues","description":"Returns a directory of art galleries, museums, and cultural venues in the United Arab Emirates. Can filter by city, category, or search term.","parameters":[{"name":"city","in":"query","description":"Filter by city (e.g., Dubai, Abu Dhabi, Sharjah)","schema":{"type":"string"},"required":false},{"name":"category","in":"query","description":"Filter by category (e.g., Art gallery, Museum, Cultural center)","schema":{"type":"string"},"required":false},{"name":"q","in":"query","description":"Search term to filter by name, category, or city","schema":{"type":"string"},"required":false},{"name":"limit","in":"query","description":"Maximum number of results (default 20, max 50)","schema":{"type":"integer","default":20,"maximum":50},"required":false}],"responses":{"200":{"description":"List of galleries and venues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryDirectoryList"}}}}}}},"/api/gpt/art-fairs":{"get":{"operationId":"searchArtFairs","summary":"Search international art fairs calendar","description":"Returns a calendar of major international art fairs and exhibitions worldwide. Can filter by country, type, and upcoming events.","parameters":[{"name":"country","in":"query","description":"Filter by country (e.g., USA, United Kingdom, Germany, France)","schema":{"type":"string"},"required":false},{"name":"type","in":"query","description":"Filter by fair type (e.g., Contemporary, Modern, Design)","schema":{"type":"string"},"required":false},{"name":"upcoming","in":"query","description":"If true (default), returns only upcoming/current fairs","schema":{"type":"boolean","default":true},"required":false},{"name":"limit","in":"query","description":"Maximum number of results (default 30, max 100)","schema":{"type":"integer","default":30,"maximum":100},"required":false}],"responses":{"200":{"description":"List of art fairs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtFairList"}}}}}}},"/api/gpt/contact":{"post":{"operationId":"sendContactMessage","summary":"Send a message to the gallery owner","description":"Sends a message directly to Amir, the gallery owner at Mondoir. Use this when someone wants to get in touch, ask a question, make an inquiry, or request assistance that requires human follow-up. The message will be emailed to the gallery owner who will respond directly.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactMessage"}}}},"responses":{"200":{"description":"Message sent successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactResponse"}}}},"400":{"description":"Invalid request - missing name or message"}}}}},"components":{"schemas":{"GalleryInfo":{"type":"object","properties":{"name":{"type":"string","description":"Gallery name"},"description":{"type":"string","description":"Gallery description"},"location":{"type":"object","properties":{"address":{"type":"string"},"city":{"type":"string"},"country":{"type":"string"},"coordinates":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"}}}}},"contact":{"type":"object","properties":{"email":{"type":"string"},"phone":{"type":"string"},"website":{"type":"string"}}},"openingHours":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"hours":{"type":"string"}}}},"services":{"type":"array","items":{"type":"string"}},"socialMedia":{"type":"object","properties":{"instagram":{"type":"string"},"twitter":{"type":"string"},"youtube":{"type":"string"}}}}},"ArtworkList":{"type":"object","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Artwork"}}}},"Artwork":{"type":"object","properties":{"title":{"type":"string"},"artist":{"type":"string"},"type":{"type":"string"},"medium":{"type":"string"},"dimensions":{"type":"string"},"year":{"type":"integer"},"price":{"type":"string"},"priceUSD":{"type":"number"},"status":{"type":"string","enum":["available","sold","on_hold"]},"url":{"type":"string"},"imageUrl":{"type":"string"}}},"ArtistList":{"type":"object","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Artist"}}}},"Artist":{"type":"object","properties":{"name":{"type":"string"},"country":{"type":"string"},"discipline":{"type":"string"},"bio":{"type":"string"},"isStudioArtist":{"type":"boolean"},"url":{"type":"string"},"imageUrl":{"type":"string"},"artworkCount":{"type":"integer"}}},"EventList":{"type":"object","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Event"}}}},"Event":{"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"},"startDate":{"type":"string","format":"date"},"endDate":{"type":"string","format":"date"},"location":{"type":"string"},"url":{"type":"string"},"imageUrl":{"type":"string"}}},"PartnerStudioInfo":{"type":"object","properties":{"description":{"type":"string"},"commissionRate":{"type":"string"},"benefits":{"type":"array","items":{"type":"string"}},"aiTools":{"type":"array","items":{"type":"string"}},"howToApply":{"type":"string"},"applicationUrl":{"type":"string"},"acceptedArtTypes":{"type":"array","items":{"type":"string"}},"payoutMethods":{"type":"array","items":{"type":"string"}}}},"GalleryDirectoryList":{"type":"object","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/GalleryVenue"}},"filters":{"type":"object","properties":{"cities":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}}}}}},"GalleryVenue":{"type":"object","properties":{"name":{"type":"string","description":"Gallery or venue name"},"category":{"type":"string","description":"Type of venue (Art gallery, Museum, etc.)"},"city":{"type":"string","description":"City in UAE"},"address":{"type":"string","description":"Full street address"},"website":{"type":"string","description":"Official website URL"},"googleMapsUrl":{"type":"string","description":"Google Maps link"},"rating":{"type":"number","description":"Google rating (0-5)"},"reviewCount":{"type":"integer","description":"Number of Google reviews"},"photoUrl":{"type":"string","description":"Photo URL"}}},"ArtFairList":{"type":"object","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ArtFair"}},"filters":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"string"}},"types":{"type":"array","items":{"type":"string"}}}}}},"ArtFair":{"type":"object","properties":{"name":{"type":"string","description":"Art fair name"},"website":{"type":"string","description":"Official website URL"},"dates":{"type":"string","description":"Date description text"},"startDate":{"type":"string","format":"date","description":"Start date"},"endDate":{"type":"string","format":"date","description":"End date"},"type":{"type":"string","description":"Fair type (Contemporary, Modern, Design, etc.)"},"city":{"type":"string","description":"City where fair is held"},"country":{"type":"string","description":"Country where fair is held"}}},"ContactMessage":{"type":"object","required":["name","message"],"properties":{"name":{"type":"string","description":"Name of the person sending the message"},"email":{"type":"string","description":"Email address for follow-up (optional but recommended)"},"message":{"type":"string","description":"The message content to send to the gallery owner"}}},"ContactResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the message was sent successfully"},"message":{"type":"string","description":"Confirmation message"},"sentTo":{"type":"string","description":"Email address the message was sent to"}}}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key required to access the Mondoir Gallery GPT endpoints"}}}}