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

Become part of the community

The Regfish DNS API is a great solution for developers who want to automate domains and DNS zones. Become part of the community and benefit from DNS automation. The DNS API is available free of charge to every Regfish customer.

More free features