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
idstringrequiredGET /api/v2/domains.Example
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.
{ "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
actionRequiredbooleanwhoisLookupStatusstring | nullok, lookup_unavailable, tld_not_supported, rate_limited, error.registrationFailureobject | nullcategorystringreasonstringdetectedAtstring | nullinterpretationobject | nullconfidencenumbercategorystringsafeToShowbooleancustomerMessage can be shown to the account holder.customerMessagestringcanRetryAfterCorrectionbooleanfieldsarray of objecttarget 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.keystringlabelstringrequiredbooleantypestringtext, select, checkbox.targetstringaccount, registrationDetails, contacts, none.profileFieldstring | nulltarget is account. Null for the other targets. One of firstName, lastName, email, street, streetNumber, city, postalCode, country, phoneNumber, state, registrationIdentifier, companyRegistrationNumber, socialSecurityNumber, vatEu.descriptionstring | nulloptionsarray of objectvaluestringlabelstringrecoveryobject | nullstatusstringready: 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 objectkeystringlabelstringrequiredbooleantypestringtext, select, checkbox.targetstringaccount, registrationDetails, contacts, none.profileFieldstring | nulltarget is account. Null for the other targets. One of firstName, lastName, email, street, streetNumber, city, postalCode, country, phoneNumber, state, registrationIdentifier, companyRegistrationNumber, socialSecurityNumber, vatEu.descriptionstring | nulloptionsarray of objectvaluestringlabelstringcheckedAtstringretryOutcomeobject | nullreasonCodestringPOST /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.terminalbooleanattemptedAtstring or nullrenewalFailureobject | nullcategorystringrenewal_window_not_open, registry_contact_review, provider_temporary, provider_account_mismatch, unknown.reasonstringdetectedAtstring | nullretryWindowDaysinteger | nullactionRequiredbooleantransferFailureobject | nullcategorystringidentity_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.reasonstringdetectedAtstring | nullrecoveryobject | nullrecovery object in a 422 from POST /api/v2/domains/{id}/actions/retry-transfer.actionstringupdate_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 objectkeystringlabelstringrequiredbooleantypestringtext, select, checkbox.targetstringaccount, transferDetails, none.descriptionstring | nulloptionsarray of objectvaluestringlabelstringsuggestedBodyobjecteppCodestringprofileUpdatedbooleantrue.recoveryValuesobjecttransferAttemptsobject | nullcurrentCodeRejected 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.failedAttemptsintegerfirstFailedAtstring or nulllastFailedAtstring or nullcurrentCodeRejectedbooleancurrentCodeRejectionsintegercurrentCodeFirstRejectedAtstring or nullrejectedCodesarray of objectcodestring or nullcodeHintstring or nullisCurrentbooleanrejectionCountintegerfirstRejectedAtstring or nulllastRejectedAtstring or nullregistryHistoryarray of objecttimestampstring | nullsubjectstring | nullcontentsstring | nulltransferErrorsClearedbooleandomainStatusSyncedbooleantransferStatusobject | nullkindstringregistry_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 | nullactionsobjectcanUpdateEppobjectPOST /api/v2/domains/{id}/actions/update-epp.allowedbooleanreasonstring | nullallowed is true.canRetryTransferobjectPOST /api/v2/domains/{id}/actions/retry-transfer is allowed now.allowedbooleanreasonstring | nullallowed is true.canRequestFreshEppobjectallowedbooleanreasonstring | nullallowed is true.capabilityobjectactions and progress instead.showProgressbooleanshowInvoicebooleanshowFailedRetrybooleanshowEppUpdatebooleanshowDualIssuesbooleanprogressobject | nulldaysPassedintegerdaysRemainingintegermaxDaysintegerpercentintegernextStepobject | nullkindstringchange_registrar_tag.registrarTagstringdeadlineDaysintegerregistrationStatusobject | nullkindstringpending: 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 | nullsupportedbooleanautoRetryobject | nullactive is true and attemptsRemaining is above zero, nothing is needed from the account holder.activebooleanreasonstring | nullattemptsRemainingintegernextRetryAtstring | nullstatestring | nullactionsobjectcanRetryRegistrationobjectPOST /api/v2/domains/{id}/actions/retry-registration is allowed now. False while an automatic retry is scheduled or the invoice is unpaid.allowedbooleanreasonstring | nullallowed is true.canFixIdentityobjectallowedbooleanreasonstring | nullallowed is true.Errors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 401 | Unauthorized. Authentication is required. |
| 403 | forbidden: 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. |
| 404 | Not found. The resource does not exist or is not owned by the caller; code is domain_not_found. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |