Skip to content
HostupDevelopers
GuidesAPI referenceSupport

human_verification_required

Verification required. HTTP status 403.

Domain availability searches without an API key need a passed human-verification check. This request had neither a verified browser nor an API key with the `read:domains` scope.

What to do

Send an API key that has the read:domains scope. A key without that scope counts as anonymous here. Browsers pass the check through POST /api/human-verification, the address in verificationUrl.

What the message says

  • Anonymous domain searches require completing the human-verification challenge first (browsers do this automatically via POST /api/human-verification). Automated clients must authenticate with an API key that has the read:domains scope.

Example

Response 403
{
  "type": "https://developer.hostup.se/errors/human_verification_required",
  "title": "Verification required",
  "status": 403,
  "detail": "Anonymous domain searches require completing the human-verification challenge first (browsers do this automatically via POST /api/human-verification). Automated clients must authenticate with an API key that has the read:domains scope.",
  "code": "human_verification_required",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3"
}

Branch on code, not on title or detail. When you contact support about it, include the requestId. More in Errors and retries.

Endpoints that return it