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. Both limits are counted across all of
your API keys and OAuth clients, so issuing another credential does not
raise them. For a legitimate bulk transfer to another registrar, support
can raise the ceilings for your account temporarily. 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.