curl -X POST "https://api.scanova.io/qr/hash/check/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"url_hash": "summer-sale",
"domain": 42
}'
{
"url_hash": ["Unavailable. Try again"]
}
QR Codes
Check hash availability
POST /qr/hash/check/
POST
/
qr
/
hash
/
check
/
curl -X POST "https://api.scanova.io/qr/hash/check/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"url_hash": "summer-sale",
"domain": 42
}'
{
"url_hash": ["Unavailable. Try again"]
}
Checks whether a custom short-URL slug is free before you commit to it.
Requires the
POST https://api.scanova.io/qr/hash/check/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
CUSTOM_URL_HASH quota.
string
required
The candidate slug: 3–50 characters,
a–z, A–Z, 0–9, _, and -.integer
Custom-domain primary key to check against. Omit for the default short domain.
boolean
Read-only — the availability verdict in the response.
curl -X POST "https://api.scanova.io/qr/hash/check/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"url_hash": "summer-sale",
"domain": 42
}'
{
"url_hash": ["Unavailable. Try again"]
}
Availability is domain-scoped — the same slug can be free on one custom domain and taken on another, so always send the
domain you intend to publish on. A successful check is not a reservation: the slug is only yours once a QR Code claims it.Related
- Generate an available hash — let the server pick a free slug instead.
- Change a QR Code’s short-URL slug — apply a checked slug to an existing QR Code.
- Create a QR Code — pass
url_hashat creation time. - QR Manager overview — the quotas, role permissions, and Trash model shared by every endpoint in this module.
- Management API overview — the auth scheme and quota rules that apply to this endpoint.
Authorizations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Response
The slug is available.
Was this page helpful?