Skip to main content
WEBHOOK
domainTransferStatusChange
{
  "eventName": "domain.transfer.status_change",
  "domainName": "example.com",
  "status": "pending_transfer"
}

Authorizations

​
Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Headers

​
X-NAMECOM-SIGNATURE
string
required

HMAC signature for the request payload. See HMAC signing documentation for example code and detailed explanation of signing.

Example:

"djasfgafgflgsdfgdsfkhfhjas,12334782,1123-3423-4dss4-354"

Body

application/json

The request sent to your server.

Payload sent when a domain transfer IN to name.com is processing. This schema represents transfer-in events where name.com is the gaining registrar.

​
eventName
enum<string>
required

The name of the subscription event

Available options:
domain.transfer.status_change
​
domainName
string
required

The domain that the transfer status has changed for

Example:

"example.com"

​
status
enum<string>
required

Terminal (finished; will not change):

  • completed: Completed.
  • failed: Failed.
  • canceled: Canceled by the user.
  • canceled_pending_refund: Canceled; refund processing.

Non-terminal (in progress; may change):

  • pending: Requested.
  • submitting_transfer: Being submitted to the registry.
  • pending_new_auth_code: New auth code required.
  • pending_unlock: Waiting for losing registrar unlock.
  • pending_registry_unlock: Waiting for registry unlock.
  • pending_transfer: Pending at the registry.
  • pending_insert: Transfer complete; domain will be added to the account.
  • rejected: Rejected at the losing registrar.
Available options:
canceled,
canceled_pending_refund,
completed,
failed,
pending,
pending_insert,
pending_new_auth_code,
pending_registry_unlock,
pending_transfer,
pending_unlock,
rejected,
submitting_transfer
Example:

"pending_transfer"

Response

The subscribed server accepted the request.