Request domain auth code | regfish DNS & TLS API

DNS automation

v1.6.2

Request domain auth code

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.

POST

/domains/{domain}/authinfo

Domains

Authentication

x-api-key

Getting startedAuthentication Regfish ConsoleCreate an API key in the regfish console and test it

Parameters

Name

Type

Format

Required

Description

domain

path

string

-

Required

Fully Qualified Domain Name.

Request example

POST

curl --request POST \
  --url 'https://api.regfish.com/domains/www.example.com/authinfo' \
  --header 'x-api-key: YOUR_API_KEY'

Responses

200

Generated auth code

application/jsonauthinfoResponse

Response example 200

{
  "success": true,
  "code": 0,
  "response": {
    "domain": "example",
    "authinfo": "example"
  }
}

401

Unauthorized

application/jsonError

Response example 401

{
  "success": false,
  "message": "Unauthorized",
  "error": "Unauthorized"
}

403

Blocked by the Domain-Guardian

application/jsonError

Response example 403

{
  "success": false,
  "message": "Blocked by the Domain-Guardian",
  "error": "Blocked by the Domain-Guardian"
}

404

Domain not found

application/jsonError

Response example 404

{
  "success": false,
  "message": "Domain not found",
  "error": "Domain not found"
}

429

Daily auth-code limit reached (per domain or per account)

application/jsonError

Response example 429

{
  "success": false,
  "message": "Daily auth-code limit reached (per domain or per account)",
  "error": "Daily auth-code limit reached (per domain or per account)"
}

500

Unexpected error

application/jsonError

Response example 500

{
  "success": false,
  "message": "Unexpected error",
  "error": "Unexpected error"
}

502

Registry error

application/jsonError

Response example 502

{
  "success": false,
  "message": "Registry error",
  "error": "Registry error"
}

Community

Diventa parte della comunità

L'API DNS Regfish è un'ottima soluzione per gli sviluppatori che desiderano automatizzare domini e zone DNS. Entra a far parte della community e beneficia dell'automazione DNS. L'API DNS è disponibile gratuitamente per ogni cliente Regfish.

Altre funzionalità gratuite