{"openapi":"3.1.0","info":{"title":"Hivex API","version":"1.0.0","description":"Read-only API for AI assistants and agents: check whether a domain is free to register, list premium domains for sale, and see the size of the .si index. No key needed.","contact":{"email":"support@hivex.si","url":"https://hivex.si"}},"servers":[{"url":"https://hivex.si"}],"paths":{"/api/v1/check":{"get":{"operationId":"checkDomain","summary":"Check if a domain is available to register right now","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"description":"A domain (example.com) or a bare word, checked as .si","example":"knowmind.si"}],"responses":{"200":{"description":"Live result from DNS and the registry's RDAP","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"status":{"type":"string","enum":["available","registered","unknown"]},"registered_at":{"type":["string","null"],"format":"date-time"},"checked_at":{"type":"string","format":"date-time"},"register_at":{"type":"array","items":{"type":"object","properties":{"registrar":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"more":{"type":"string","format":"uri"}}}}}},"400":{"description":"Not a valid domain"}}}},"/api/v1/premium":{"get":{"operationId":"listPremiumDomains","summary":"List premium domains for sale (any extension), paid through Escrow.com","responses":{"200":{"description":"Domains for sale","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"payment":{"type":"string"},"domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","example":"taxmind.si"},"price_usd":{"type":["integer","null"],"description":"Buy-now price; null means offers only"},"min_offer_usd":{"type":["integer","null"]},"buy":{"type":"string","enum":["buy_now_or_offer","offer_only"]},"tagline":{"type":["string","null"]},"summary":{"type":["string","null"]},"good_for":{"type":"array","items":{"type":"string"}},"also_registered_on":{"type":"array","items":{"type":"string"},"description":"Extensions where the same word is already taken"},"url":{"type":"string","format":"uri","description":"Page to buy or make an offer"}}}}}}}}}}}},"/api/v1/stats":{"get":{"operationId":"indexStats","summary":"Size and freshness of the index of .si names free to register","responses":{"200":{"description":"Counts and build time"}}}}}}