Request domain auth code
POST /domains/{domain}/authinfoOperation ID: RequestAuthinfoByDomain
Generates the transfer authorization code (AuthInfo) for the domain at the
registry. The code enables an outbound transfer, request it only on the
domain owner’s explicit demand. Guarded by the Domain-Guardian
(authinfo rule class) and limited to 3 requests per domain and
10 per account per day, the account limit is what bounds a bulk
harvest across the whole portfolio. Every issued code is recorded in
the domain guard log (outcome issued), as is every refusal.
Path parameters
Section titled “Path parameters”| Name | Type | Required | Description |
|---|---|---|---|
domain |
fqdn_relaxed | yes | — |
Responses
Section titled “Responses”| Status | Type | Description |
|---|---|---|
200 |
authinfoResponse |
Generated auth code |
401 |
Error |
Unauthorized |
403 |
Error |
Blocked by the Domain-Guardian |
404 |
Error |
Domain not found |
429 |
Error |
Daily auth-code limit reached (per domain or per account) |
500 |
Error |
Unexpected error |
502 |
Error |
Registry error |
Response body
Section titled “Response body”| Field | Type | Required | Description |
|---|---|---|---|
success |
boolean |
yes | Success indicator |
code |
integer |
no | Response/Error Code |
response |
authinfoResponse | no | — |
Example
Section titled “Example”curl -X POST "https://api.regfish.com/domains/<domain>/authinfo" \ -H "x-api-key: $REGFISH_API_KEY"Build a request
Section titled “Build a request”Fill in values — the call below updates as you type. Nothing is sent: the API does not currently allow browser requests from this domain (CORS). The API key is not stored.