Skip to content

Get registration and transfer status

GET /api/v2/domains/{id}/lifecycle

Explains where a domain’s registration, transfer or renewal stands and what is blocking it. Use it when a domain stays pending or a transfer does not complete. actionRequired is true only when the account holder must do something now. registrationFailure, transferFailure and renewalFailure give the reason for a failure. The actions gates in transferStatus and registrationStatus say which retry is allowed. Retry with POST /api/v2/domains/{id}/actions/retry-transfer or POST /api/v2/domains/{id}/actions/retry-registration. Reading it can also update the domain’s status to match the registry (domainStatusSynced).

Authentication: An API key with the scope read:domains. About keys and scopes

Request

Path parameters

idstringrequired
The domain ID. From GET /api/v2/domains.

Example

GET /api/v2/domains/{id}/lifecycle
curl "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/lifecycle" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 Where the domain’s registration, transfer and renewal stand.

Response 200
{
"actionRequired": false,
"whoisLookupStatus": "ok",
"renewalFailure": null,
"registrationFailure": null,
"transferFailure": {
"category": "provider_identity_delivery_failed",
"reason": "The transfer could not use an identity detail that is already saved on the account. No account update is needed; support must review the transfer if it still cannot be completed.",
"detectedAt": "2026-07-12T20:04:55.537Z",
"recovery": null
},
"transferAttempts": {
"failedAttempts": 1,
"firstFailedAt": "2026-07-12T20:04:55.537Z",
"lastFailedAt": "2026-07-12T20:04:55.537Z",
"currentCodeRejected": false,
"currentCodeRejections": 0,
"currentCodeFirstRejectedAt": null,
"rejectedCodes": []
},
"registryHistory": [
{
"timestamp": "2026-04-27T12:00:00.000Z",
"subject": "[Initiated] Transfer status",
"contents": "Incoming transfer initiated at registry. The transfer will be processed in 5 days unless explicitly rejected."
}
],
"transferErrorsCleared": false,
"domainStatusSynced": false,
"transferStatus": {
"kind": "transfer_error_known",
"reason": "The transfer could not use an identity detail that is already saved on the account. No account update is needed; support must review the transfer if it still cannot be completed.",
"actions": {
"canUpdateEpp": {
"allowed": false,
"reason": "The current transfer issue is not related to the authorization code."
},
"canRetryTransfer": {
"allowed": false,
"reason": "The transfer could not use an identity detail that is already saved on the account. No account update is needed; support must review the transfer if it still cannot be completed."
},
"canRequestFreshEpp": {
"allowed": false,
"reason": "The current transfer issue is not related to the authorization code."
}
},
"capability": {
"showProgress": false,
"showInvoice": false,
"showFailedRetry": false,
"showEppUpdate": false,
"showDualIssues": false
},
"progress": null,
"nextStep": null
},
"registrationStatus": {
"kind": "unknown",
"reason": null,
"supported": true,
"autoRetry": null,
"actions": {
"canRetryRegistration": {
"allowed": false,
"reason": "Registration retry is only available while the order is pending."
},
"canFixIdentity": {
"allowed": false,
"reason": "Identity details can only be fixed after an identity-related registration failure."
}
}
}
}
Response fields
actionRequiredboolean
True when the account holder must act before the domain can continue. A registration failure counts only while the registration is still pending.
whoisLookupStatusstring | null
Result of the WHOIS lookup made for a pending transfer. Null when no lookup was needed. One of ok, lookup_unavailable, tld_not_supported, rate_limited, error.
registrationFailureobject | null
The latest registration failure while the registration is pending. Null otherwise.
categorystring
reasonstring
detectedAtstring | null
interpretationobject | null
Reading of the latest failed registration, with the fields a retry can correct.
confidencenumber
How certain the reading is, from 0 to 1.
categorystring
safeToShowboolean
True when customerMessage can be shown to the account holder.
customerMessagestring
Plain-text explanation of the failure.
canRetryAfterCorrectionboolean
True when a retry can succeed once the listed fields are corrected.
fieldsarray of object
Fields to correct. Branch on target and profileField, not label. account: update the account details, then retry with profileUpdated: true. registrationDetails: send the values as recoveryValues to POST /api/v2/domains/{id}/actions/retry-registration.
keystring
labelstring
requiredboolean
typestring
One of text, select, checkbox.
targetstring
One of account, registrationDetails, contacts, none.
profileFieldstring | null
Account field to correct when target is account. Null for the other targets. One of firstName, lastName, email, street, streetNumber, city, postalCode, country, phoneNumber, state, registrationIdentifier, companyRegistrationNumber, socialSecurityNumber, vatEu.
descriptionstring | null
optionsarray of object
valuestring
labelstring
recoveryobject | null
What a registration retry needs now, checked against the current account details.
statusstring
ready: the retry can be sent as it is. needs_input: the fields in missing must be filled first. One of ready, needs_input.
missingarray of object
Fields that block the retry.
keystring
labelstring
requiredboolean
typestring
One of text, select, checkbox.
targetstring
One of account, registrationDetails, contacts, none.
profileFieldstring | null
Account field to correct when target is account. Null for the other targets. One of firstName, lastName, email, street, streetNumber, city, postalCode, country, phoneNumber, state, registrationIdentifier, companyRegistrationNumber, socialSecurityNumber, vatEu.
descriptionstring | null
optionsarray of object
valuestring
labelstring
checkedAtstring
When the account details were checked.
retryOutcomeobject | null
The last retry the registry refused.
reasonCodestring
Why the retry was refused. Same codes as the 409 from POST /api/v2/domains/{id}/actions/retry-registration. One of domain_not_available, registrant_data_missing, invalid_auth, registry_rejected, provider_temporary, auto_retry_scheduled, unknown.
terminalboolean
True when another retry cannot change the outcome.
attemptedAtstring or null
When the refused retry was sent.
renewalFailureobject | null
The latest renewal failure that is not resolved. Null when there is none.
categorystring
One of renewal_window_not_open, registry_contact_review, provider_temporary, provider_account_mismatch, unknown.
reasonstring
detectedAtstring | null
retryWindowDaysinteger | null
At least 1.
actionRequiredboolean
transferFailureobject | null
The latest transfer failure. Null when there is none.
categorystring
identity_details_ready: the transfer can be retried as it is, without changing account details or the transfer code. provider_identity_delivery_failed: a retry still could not use an identity detail already saved on the account. recovery is then null because entering the same value again does not help.
reasonstring
detectedAtstring | null
recoveryobject | null
What must be provided before the transfer can be retried. Same shape as the recovery object in a 422 from POST /api/v2/domains/{id}/actions/retry-transfer.
actionstring
update_account_details or provide_transfer_details. Branch on this value, not on the error text. One of update_account_details, provide_transfer_details.
fieldsarray of object
keystring
labelstring
requiredboolean
typestring
One of text, select, checkbox.
targetstring
One of account, transferDetails, none.
descriptionstring | null
optionsarray of object
valuestring
labelstring
suggestedBodyobject
eppCodestring
profileUpdatedboolean
One of true.
recoveryValuesobject
transferAttemptsobject | null
Failed transfer attempts for a pending transfer. Null when the domain is not a pending transfer or no attempt has failed. currentCodeRejected is true when the transfer code on file is one the registry already rejected. A retry with that code is refused unless it sends force: true. rejectedCodes lists each code the registry refused. A code that is still valid is never returned.
failedAttemptsinteger
Number of failed transfer attempts.
firstFailedAtstring or null
When the first attempt failed.
lastFailedAtstring or null
When the latest attempt failed.
currentCodeRejectedboolean
True when the transfer code on file was already rejected by the registry.
currentCodeRejectionsinteger
How many times the registry rejected the code on file.
currentCodeFirstRejectedAtstring or null
When the registry first rejected the code on file.
rejectedCodesarray of object
Each transfer code the registry rejected, newest rejection first. Empty when none was rejected.
codestring or null
The rejected code. Null for older records.
codeHintstring or null
Short form of the code (first and last characters) for messages that must not repeat it.
isCurrentboolean
True when this is the code saved on the domain now. A retry with it fails again.
rejectionCountinteger
How many times the registry rejected this code.
firstRejectedAtstring or null
When the registry first rejected this code.
lastRejectedAtstring or null
When the registry last rejected this code.
registryHistoryarray of object
Registry events for the domain.
timestampstring | null
subjectstring | null
contentsstring | null
transferErrorsClearedboolean
True when this read found the transfer in progress at the registry and cleared earlier transfer errors.
domainStatusSyncedboolean
True when this read updated the domain’s status to match the registry.
transferStatusobject | null
Transfer state, its action gates and progress. Null when the domain could not be read.
kindstring
registry_locked: a transfer lock at the current registrar or the holder’s own lock blocks the transfer. registry_suspended: the registry has put the domain on hold. Unlocking, a new transfer code or a retry does not help. Every action is closed with a reason. The transfer can go through with the same code once the current registrar has the hold lifted. One of pending_transfer_in_progress, registrar_push_required, registrar_push_request_required, transfer_failed_at_registry, transfer_not_at_registry, pending_transfer_generic, awaiting_payment, registry_locked_and_epp_invalid, registry_locked, registry_suspended, too_new_for_transfer, transfer_error_known, pending_epp_fallback, active, expired, unknown.
reasonstring | null
actionsobject
canUpdateEppobject
True when you can send a new transfer code with POST /api/v2/domains/{id}/actions/update-epp.
allowedboolean
reasonstring | null
Why the action is not allowed. Null when allowed is true.
canRetryTransferobject
True when POST /api/v2/domains/{id}/actions/retry-transfer is allowed now.
allowedboolean
reasonstring | null
Why the action is not allowed. Null when allowed is true.
canRequestFreshEppobject
True when a new transfer code from the current registrar can help.
allowedboolean
reasonstring | null
Why the action is not allowed. Null when allowed is true.
capabilityobject
Display hints for the client area. Branch on actions and progress instead.
showProgressboolean
showInvoiceboolean
showFailedRetryboolean
showEppUpdateboolean
showDualIssuesboolean
progressobject | null
Estimated progress through the automatic transfer approval window. Uses the registry’s own duration when known, otherwise five days for generic TLDs. Null for country-code and unknown TLDs.
daysPassedinteger
daysRemaininginteger
Whole days left until the transfer is expected to complete. Never below zero.
maxDaysinteger
percentinteger
nextStepobject | null
For a .uk transfer once the request is active: the registrar tag to set and the deadline in days. Null until the request has been submitted.
kindstring
One of change_registrar_tag.
registrarTagstring
deadlineDaysinteger
registrationStatusobject | null
Registration state and its action gates. Null when the domain could not be read.
kindstring
pending: the registration is being processed. failed: it failed and waits for a retry. active: the domain is registered. unknown: not a registration (for example a transfer), or the state could not be read. One of pending, failed, active, unknown.
reasonstring | null
supportedboolean
autoRetryobject | null
Automatic retries after a temporary registration failure. While active is true and attemptsRemaining is above zero, nothing is needed from the account holder.
activeboolean
reasonstring | null
attemptsRemaininginteger
nextRetryAtstring | null
statestring | null
actionsobject
canRetryRegistrationobject
True when POST /api/v2/domains/{id}/actions/retry-registration is allowed now. False while an automatic retry is scheduled or the invoice is unpaid.
allowedboolean
reasonstring | null
Why the action is not allowed. Null when allowed is true.
canFixIdentityobject
True after a registration failed on the identification number. Correct it in the account details, then retry.
allowedboolean
reasonstring | null
Why the action is not allowed. Null when allowed is true.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

401Unauthorized. Authentication is required.
403forbidden: the API key lacks read:domains (requiredScopes lists it) or the account is not active. A domain on another account answers 404 domain_not_found.
404Not found. The resource does not exist or is not owned by the caller; code is domain_not_found.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.