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. 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.

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

Forma parte de la comunidad

La DNS API de regfish es una gran solucion para desarrolladores que quieren automatizar dominios y zonas DNS. Sumate a la comunidad y aprovecha las ventajas de la automatizacion DNS. La DNS API esta disponible gratis para todos los clientes de regfish.

Mas funciones gratis