TIPTIP
API Reference

Check availability

GET
/v1/availability/{tag}

Answers whether a tag can be registered right now. Unlike the other tag endpoints, malformed input is not a 400 here: this endpoint's whole purpose is to report on a tag's status, so "no, it's not even valid" is a normal 200 answer (reason: invalid), not an error. The other reasons a tag can be unavailable are reserved (on the protocol's reserved list), inappropriate (fails the profanity filter), and already_registered (an active row already exists).

Path Parameters

tag*string

Response Body

application/json

curl -X GET "https://example.com/v1/availability/string"
{  "tag": "@daniel",  "available": true,  "reason": "available"}