{"openapi":"3.1.0","info":{"title":"Signet username check API","version":"0.1.0","description":"Telegram username availability, routes and alternatives. Advice-only observations from public sources (Fragment pages, TonAPI) at checked_at; availability can change at any moment and Telegram's own Settings check is final. Signet does not sell, price, buy, hold or transfer usernames, relays no offers, and is not affiliated with Telegram or Fragment. Any prices are labelled third-party observations, not quotes, and nothing here is financial or investment advice."},"servers":[{"url":"https://getsignet.me"}],"paths":{"/v1/check":{"get":{"operationId":"checkHandles","summary":"Check up to 10 usernames","parameters":[{"name":"handles","in":"query","required":true,"description":"Comma-separated usernames (max 10)","schema":{"type":"string"},"example":"coffee,qzxv7kpw2"}],"responses":{"200":{"description":"Results","content":{"application/json":{"schema":{"type":"object","required":["ok","checked_at","disclaimer"],"properties":{"ok":{"type":"boolean"},"data":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/HandleIntel"}}}},"error":{"$ref":"#/components/schemas/Error"},"checked_at":{"type":"number","description":"Unix seconds (UTC)"},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["ok","checked_at","disclaimer"],"properties":{"ok":{"type":"boolean"},"data":{"type":"null"},"error":{"$ref":"#/components/schemas/Error"},"checked_at":{"type":"number","description":"Unix seconds (UTC)"},"disclaimer":{"type":"string"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait"}},"content":{"application/json":{"schema":{"type":"object","required":["ok","checked_at","disclaimer"],"properties":{"ok":{"type":"boolean"},"data":{"type":"null"},"error":{"$ref":"#/components/schemas/Error"},"checked_at":{"type":"number","description":"Unix seconds (UTC)"},"disclaimer":{"type":"string"}}}}}}}}},"/v1/report/{handle}":{"get":{"operationId":"handleReport","summary":"Detailed report for one username","parameters":[{"name":"handle","in":"path","required":true,"schema":{"type":"string"},"example":"coffee"}],"responses":{"200":{"description":"Report","content":{"application/json":{"schema":{"type":"object","required":["ok","checked_at","disclaimer"],"properties":{"ok":{"type":"boolean"},"data":{"$ref":"#/components/schemas/HandleReport"},"error":{"$ref":"#/components/schemas/Error"},"checked_at":{"type":"number","description":"Unix seconds (UTC)"},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["ok","checked_at","disclaimer"],"properties":{"ok":{"type":"boolean"},"data":{"type":"null"},"error":{"$ref":"#/components/schemas/Error"},"checked_at":{"type":"number","description":"Unix seconds (UTC)"},"disclaimer":{"type":"string"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait"}},"content":{"application/json":{"schema":{"type":"object","required":["ok","checked_at","disclaimer"],"properties":{"ok":{"type":"boolean"},"data":{"type":"null"},"error":{"$ref":"#/components/schemas/Error"},"checked_at":{"type":"number","description":"Unix seconds (UTC)"},"disclaimer":{"type":"string"}}}}}}}}},"/v1/suggest":{"post":{"operationId":"suggestHandles","summary":"Suggest available usernames from a brief","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["brief"],"properties":{"brief":{"type":"string","maxLength":500},"limit":{"type":"integer","minimum":1,"maximum":12,"default":8}}}}}},"responses":{"200":{"description":"Suggestions","content":{"application/json":{"schema":{"type":"object","required":["ok","checked_at","disclaimer"],"properties":{"ok":{"type":"boolean"},"data":{"$ref":"#/components/schemas/SuggestResult"},"error":{"$ref":"#/components/schemas/Error"},"checked_at":{"type":"number","description":"Unix seconds (UTC)"},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["ok","checked_at","disclaimer"],"properties":{"ok":{"type":"boolean"},"data":{"type":"null"},"error":{"$ref":"#/components/schemas/Error"},"checked_at":{"type":"number","description":"Unix seconds (UTC)"},"disclaimer":{"type":"string"}}}}}},"429":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait"}},"content":{"application/json":{"schema":{"type":"object","required":["ok","checked_at","disclaimer"],"properties":{"ok":{"type":"boolean"},"data":{"type":"null"},"error":{"$ref":"#/components/schemas/Error"},"checked_at":{"type":"number","description":"Unix seconds (UTC)"},"disclaimer":{"type":"string"}}}}}}}}},"/healthz":{"get":{"operationId":"health","summary":"Liveness","responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retry_after_s":{"type":"number"}}},"Fact":{"type":"object","properties":{"value":{},"source":{"type":"string"},"checked_at":{"type":"number"}}},"HandleIntel":{"type":"object","properties":{"handle":{"type":"string"},"route":{"type":"string","enum":["claim_free","start_auction","bid_auction","buy_listing","owned_not_for_sale","taken_by_account","invalid","unknown"]},"how_to_get":{"type":"string"},"checked_at":{"type":"number"},"facts":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Fact"}},"risk_notes":{"type":"array","items":{"type":"string"}},"fragment_url":{"type":["string","null"]},"notes":{"type":"array","items":{"type":"string"}},"watch_url":{"type":["string","null"]}}},"HandleReport":{"allOf":[{"$ref":"#/components/schemas/HandleIntel"},{"type":"object","properties":{"route_explained":{"type":"string"},"facts_readable":{"type":"object","additionalProperties":{"type":"string"}}}}]},"SuggestResult":{"type":"object","properties":{"brief":{"type":"string"},"seeds":{"type":"array","items":{"type":"string"}},"suggestions":{"type":"array","items":{"type":"object","properties":{"handle":{"type":"string"},"why":{"type":"string"},"trademark_flag":{"type":["string","null"]},"intel":{"$ref":"#/components/schemas/HandleIntel"},"watch_url":{"type":"string"}}}},"checked":{"type":"integer"},"notes":{"type":"array","items":{"type":"string"}}}}}}}