Domain Transfer In Status Change

Sent when you have subscribed to the event on your account, and a domain transfer IN to name.com is processing. This webhook reports status changes for transfers where name.com is the gaining registrar (i.e., transfers into your name.com account).

WEBHOOK domainTransferStatusChange

Example

{
  "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

200

The subscribed server accepted the request.