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

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