Error codes
Every error is a Problem Details document with a stable code. Branch on the code, never on the text. How errors look and which ones are safe to retry: Errors and retries.
Authentication & Authorization
forbidden | 403 | Forbidden |
invalid_credentials | 401 | Invalid credentials |
unauthorized | 401 | Unauthorized |
Validation
invalid_country_code | 400 | Validation failed |
invalid_cursor | 400 | Invalid cursor |
invalid_pagination_limit | 400 | Invalid limit |
invalid_public_key | 400 | Invalid SSH public key |
invalid_request | 400, 409, 422 | Invalid request |
password_too_weak | 400 | Password too weak |
General
account_closure_blocked | 409 | Account cannot be closed yet |
account_inactive | 403, 409 | Account inactive |
allocation_changed | 409 | Allocation changed |
billing_change_busy | 409 | Billing change in progress |
billing_currency_unavailable | 502 | Billing currency unavailable |
billing_state_unavailable | 503 | Billing state unavailable |
bulk_payment_retired | 410 | Bulk payment retired |
cloud_storage_limit_exceeded | 403 | Storage limit reached |
cloudflare_unavailable | 503 | Cloudflare unavailable |
combined_renewal_order | 409 | Combined renewal order |
confirmation_required | 400 | Confirmation required |
contact_permission_required | 403 | Not allowed |
cooldown_active | 409, 429 | Cooldown active |
country_not_supported | 403 | Country not supported |
ddos_mitigation_active | 409 | DDoS mitigation already active |
ddos_scrubbing_unavailable_for_ip | 409 | DDoS filtering unavailable for this IP range |
delegated_access_forbidden | 403 | Forbidden |
destination_verification_required | 409 | Destination address must be verified |
disk_throttle_requires_support | 403 | Disk limit is lifted by support |
disk_throttle_state_conflict | 409 | Disk limit changed |
email_in_use | 409 | Address already in use |
email_verification_not_required | 409 | Email verification action unavailable |
email_verification_recipient_unavailable | 409 | Email verification action unavailable |
email_verification_recipient_unreachable | 409 | Email verification action unavailable |
epp_code_unavailable | 409 | Transfer code unavailable |
guest_agent_unavailable | 409 | Guest Agent unavailable |
holder_change_contact_incomplete | Holder change contact incomplete | |
holder_change_session_required | 409 | Holder change session required |
holder_change_verification_required | 400 | Holder change verification required |
holder_details_mismatch | Holder details mismatch | |
human_verification_required | 403 | Verification required |
insufficient_trusted_history | Insufficient trusted history | |
invalid_charge_consent_request | 400 | Invalid request |
invalid_cidr | 400 | Invalid CIDR |
invalid_mail_relay_quota_request | 400 | Invalid mail relay quota request |
ip_change_awaiting_payment | 409 | IP change awaiting payment |
ip_change_quote_changed | 409 | Confirm IP change |
job_not_found | 404 | Job not found |
link_expired | 410 | Link expired |
lookup_unavailable | 503 | Lookup temporarily unavailable |
mail_relay_block_not_found | 404 | Paused sender not found |
mail_relay_quota_purchase_conflict | 409 | Mail relay quota purchase conflict |
name_in_use | 409 | Name already in use |
no_cloud_access | 403 | No cloud access |
not_allowed | 409 | Action not allowed |
not_available_in_country | 403 | Not available in country |
not_found | 404 | Not found |
not_supported | 409 | Not supported |
not_verified | 403 | Cloud VM deployment unavailable |
order_permission_required | 403 | Permission required |
parent_cidr_mismatch | 409 | Parent CIDR mismatch |
password_change_acknowledgement_required | 409 | Password change required |
password_policy_rejected | 400 | Password rejected |
paused_under_attack | 409 | IPv4 changes paused |
payg_access_required | 403 | PAYG access required |
payg_access_unavailable | 403 | PAYG access unavailable |
payg_payment_overdue | 403 | Forbidden |
payment_failed | 400 | Payment failed |
payment_method_invalid | 409 | Payment method invalid |
rate_limit_exceeded | 429 | Too many requests |
rate_limited | 429 | Rate limited |
registration_not_retryable | 409 | Registration not retryable |
registration_recovery_required | 422 | Registration needs details |
registration_retry_in_progress | 409 | Registration not retryable |
renewal_period_review_required | 409 | Renewal period needs review |
renewal_pricing_unavailable | 502 | Renewal pricing unavailable |
resolve_not_available | 409 | Nothing to resolve |
resource_in_use | 409 | Resource still in use |
restore_intent_failed | 503 | Restore scheduling failed |
routed_ipv6_moved | 410 | Routed IPv6 moved |
routed_ipv6_next_hop_missing | 409 | Routed IPv6 conflict |
routed_ipv6_pool_exists | 409 | Routed IPv6 conflict |
routed_ipv6_pool_has_routes | 409 | Routed IPv6 pool has active routes |
routed_ipv6_pool_not_found | 404 | Not found |
same_product_plan | 409 | Plan change not needed |
scheduled_change_in_progress | 409 | Scheduled change in progress |
scheduled_change_not_cancellable | 409 | Scheduled change cannot be cancelled |
scheduled_change_not_found | 404 | Scheduled change not found |
scheduled_change_processing_unavailable | 409 | Scheduled changes unavailable |
server_not_eligible | 409 | Server unavailable |
service_billing_unavailable | 503 | Billing state unavailable |
service_change_in_progress | 409 | Change in progress |
service_not_active | 409 | Service not active |
service_not_found | 404 | Service not found |
service_unavailable | 503 | Service unavailable |
source_holder_changed | Source holder changed | |
ssh_access_changed | 409 | SSH access changed |
staging_destination_not_ready | 409 | Staging destination not ready |
storage_limit_exceeded | 403 | Cloud VM conversion unavailable |
subnet_pool_exhausted | 409 | Subnet pool exhausted |
target_storage_too_small | 409 | Restore unavailable |
unblock_limit_reached | 429 | Unblock limit reached |
unsupported_plan_transition | 409 | Plan change unavailable |
vat_invalid | VAT invalid | |
verification_failed | 403 | Verification failed |
wordpress_site_not_served_here | 409 | WordPress site is not served by this hosting |
wp_installation_not_found | 404 | Not found |
Billing & Payments
blocked_expired_invoice | Blocked expired invoice | |
cancellation_blocked_overdue_invoice | 409 | Cancellation blocked by overdue invoice |
card_not_found | 404 | Card not found |
country_not_eu | 422 | Country not in VIES |
credit_note_unavailable | 409 | Credit note unavailable |
existing_invoice_blocking | 409 | Existing invoice blocks the change |
existing_invoice_not_cancellable | 409 | Existing invoice not cancellable |
has_unpaid_invoice | 409 | Cloud VM conversion blocked |
invoice_already_paid | 409 | Invoice already paid |
invoice_not_found | 404 | Invoice not found |
invoice_not_payable | Invoice not payable | |
invoice_payment_in_progress | 409 | Invoice payment already in progress |
invoice_reissue_blocked | 409 | Invoice cannot be reissued |
no_card_on_file | 403 | Cloud VM restore unavailable |
not_cancelable | 409 | Cannot be cancelled |
order_not_found | 404 | Order not found |
overdue_invoice_blocking | 409 | Overdue invoice blocking |
payment_method_unavailable | 409 | No available payment method |
payment_required | 402 | Payment required |
pending_orders | 409 | Pending orders present |
plan_not_found | 404 | Plan not found |
product_not_found | 404 | Product not found |
product_not_orderable | 409 | Product not orderable |
promo_rejected | 409 | Promotion rejected |
service_cancellation_pending | 409 | Service is set to be cancelled |
VPS & Cloud
backup_listing_unavailable | 503 | Backups unavailable |
backup_not_found | 404 | Backup not found |
backup_not_restorable | 409 | Database backup cannot be restored |
backup_schedule_limit_reached | 409 | Backup schedule limit reached |
backup_schedule_not_found | 404 | Backup schedule not found |
backup_slots_full | 409 | Backup slots full |
backup_temporarily_locked | 409 | Backup temporarily locked |
cidr_overlap | 409 | CIDR overlap |
firewall_group_not_found | 404 | Firewall group not found |
firmware_update_failed | 409 | Firmware update failed |
floating_ip_assign_failed | 502 | Reserved IP assignment failed |
floating_ip_assigned | 409 | Reserved IP is assigned |
floating_ip_not_found | 404 | Reserved IP not found |
floating_ip_quota_reached | 409 | Reserved IP limit reached |
floating_ip_unassign_failed | 502 | Reserved IP detach failed |
group_in_use | 409 | Firewall group is in use |
network_deprovisioning | 409 | Network deprovisioning |
network_in_use | 409 | Network in use |
network_limit_reached | 409 | Network limit reached |
no_vlan_available | 409 | No VLAN available |
not_a_vps | 400 | VPS required |
port25_request_pending | 409 | Port 25 request already pending |
port25_requirements_not_met | 403 | Port 25 requirements not met |
private_network_not_found | 404 | Private network not found |
private_network_setup_required | 402 | Payment required |
rdns_ip_not_on_vps | 403 | Address not assigned to this VPS |
snapshot_schedule_not_found | 404 | Snapshot schedule not found |
template_name_conflict | 409 | Template name already exists |
template_not_found | 404 | Template not found |
volume_attached | 400 | Volume is attached |
volume_not_found | 404 | Volume not found |
vps_not_active | 409 | VPS not active |
vps_not_found | 404 | VPS not found |
vps_not_ready | 409 | VPS not ready |
vps_not_running | 409 | VPS not running |
vps_ownership_mapping_conflict | 409 | VPS ownership mapping conflict |
vps_pin_not_found | 404 | VPS pin not found |
Domains & DNS
auto_renew_unavailable | 409 | Auto-renew unavailable |
dns_busy | 409 | DNS setup |
dns_changed | 409 | DNS setup |
dns_conflict | 409 | DNS conflict |
dns_forwarding_active | 409 | DNS setup |
dns_mail_key_unavailable | 409 | DNS setup |
dns_mirror_pending | 409 | DNS setup |
dns_not_enabled | 409 | DNS setup |
dns_plan_conflict | 409 | DNS setup |
dns_read_unavailable | 503 | DNS setup |
dns_record_limit_exceeded | 409 | DNS record limit reached |
dns_record_not_found | 404 | DNS record not found |
dns_record_proxy_blocked | 409 | DNS record proxy change blocked |
dns_redirect_active | 409 | DNS setup |
dns_setup_choice_required | 409 | DNS setup choice required |
dns_zone_activating | 409 | DNS zone is still activating |
dns_zone_not_found | 404 | DNS zone not found |
dnssec_recovery_required | 422 | DNSSEC change needs details |
domain_conflict | 409 | Domain conflict |
domain_delete_blocked | 409 | Domain delete blocked |
domain_dns_not_found | 404 | Domain DNS not found |
domain_dns_parking_conflict | 409 | Parking page conflicts with root address records |
domain_not_active | 409 | Domain not active |
domain_not_attached | 502, 503 | DNS setup |
domain_not_available | 409 | Registration retry failed |
domain_not_eligible | 400, 409 | Domain not eligible |
domain_not_found | 404 | Domain not found |
domain_not_owned | 403 | Domain not owned by hosting account |
domain_not_ready | 409 | Domain not ready for hosting |
domain_not_renewable | 409 | Domain not renewable |
domain_order_in_progress | 409 | Domain order in progress |
domain_verification_unavailable | 503 | Domain verification unavailable |
dyndns_config_not_found | 404 | DynDNS configuration not found |
email_forwarding_busy | 409 | Forwarding change unavailable |
email_forwarding_destination_already_verified | 409 | Destination address cannot be reset |
email_forwarding_destination_not_found | 404 | Destination address not found |
email_forwarding_enable_failed | 502 | Email forwarding could not be enabled |
email_forwarding_loop | 400 | Forwarding change unavailable |
email_forwarding_not_editable | 409 | Rule cannot be edited |
email_forwarding_not_found | 404 | Email forwarding not available |
email_forwarding_rule_not_found | 404 | Email forwarding rule not found |
glue_host_not_registered | Glue host not registered | |
glue_record_in_use | 409 | Glue record in use |
hosting_domain_impact_confirmation_required | 409 | Confirm every hosted domain |
main_domain_change_unavailable | 409 | Main domain cannot be changed |
mx_record_blocked_email_forwarding | 400 | MX record blocked by email forwarding |
mx_records_conflict | 409 | Existing MX records conflict |
nameserver_recovery_required | 422 | Nameserver change needs details |
nameserver_update_blocked | 409 | Nameserver update blocked |
nameservers_not_correct | Nameservers not correct | |
no_pending_renewal | 409 | No pending renewal |
redirect_not_found | 404 | Redirect not found |
redirect_service_unavailable | 502, 503 | Redirect service unavailable |
registrant_transfer_required | Registrant transfer required | |
registry_lock_activation_blocked | 409 | Registry lock activation blocked |
registry_lock_dnssec_incomplete | 409 | DNSSEC is not complete |
registry_lock_unlock_required | 409 | Registry lock unlock required |
registry_locked | Registry locked | |
snapback_not_found | 404 | Snapback request not found |
tld_not_supported | 400, 404, 422 | TLD not supported |
transfer_blocked | 409 | Transfer blocked |
transfer_not_in_progress | 409 | Transfer not in progress |
transfer_recovery_required | 422 | Transfer needs details |
CDN
cdn_proxy_rule_not_found | 404 | Proxy rule not found |
cdn_zone_not_found | 404 | CDN zone not found |
Web Hosting
account_not_eligible_cpanel | 409 | Control panel action unavailable |
account_suspended | 409 | Hosting account suspended |
shared_hosting_not_found | 404 | Shared hosting account not found |
Object Storage
bucket_not_found | 404 | Bucket not found |
object_storage_not_enabled | 400 | Object storage not enabled |
Support
attachment_not_found | 404 | Attachment not found |
ticket_close_not_allowed | 409 | Ticket cannot be closed |
ticket_not_found | 404 | Ticket not found |
Account & Security
api_key_not_found | 404 | API key not found |
bankid_personnummer_not_found | 404 | BankID personnummer not found |
bankid_verification_required | 401 | BankID verification required |
duplicate_fingerprint | 409 | Duplicate SSH key |
ssh_key_already_exists | 409 | SSH key already exists |
ssh_key_not_found | 404 | SSH key not found |
Upstream / Provider
Server Errors
internal_error | 500 | Internal server error |