{"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, 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/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/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"}}},"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"}}}},"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"}}}}