# mijn.host API

## Docs
- Getting started [Introduction](https://mijn.host/api/doc/doc-343215.md): 
- Getting started [Base url](https://mijn.host/api/doc/doc-343218.md): 
- Getting started [Authentication](https://mijn.host/api/doc/doc-343216.md): 
- Getting started [Response codes](https://mijn.host/api/doc/doc-343217.md): 

## API Docs
- Domains > Domains [List domains](https://mijn.host/api/doc/api-3563872.md): Retrieve all domains from your account
- Domains > Domains [Get domain](https://mijn.host/api/doc/api-3563900.md): Retrieve details of a specific domain (includes `forwarder_enabled`, `forwarder`, `forwarder_blocked_by_hosting`, and `tags`; tag shape matches `GET /domains/`).
- Domains > Domains [Update domain](https://mijn.host/api/doc/api-3563902.md): Update domain settings of an existing domain in your account. Optional fields left empty will not be updated. Optional `dnssec.enabled` false removes all DNSSEC keys. Optional `forwarder` updates the URL forwarder (`enabled`, `type`, `url`). Optional `tags` replaces the domain's tag set when provided.
- Domains > Domains [Cancel domain](https://mijn.host/api/doc/api-3563903.md): Cancel a domain. Domain will be cancelled before renewal date.
- Domains > Domains [Cancel domain deletion](https://mijn.host/api/doc/api-3890303.md): Cancel the deletion of a domain.
- Domains > Domains [Get DNS records](https://mijn.host/api/doc/api-3563906.md): Retrieve DNS records of specific domain.
- Domains > Domains [Update DNS records](https://mijn.host/api/doc/api-3563907.md): Update DNS records of specific domain. This will replace all existing DNS records of the domain.
- Domains > Domains [Update single DNS record](https://mijn.host/api/doc/api-3600003.md): Update a single DNS record of a specific domain.
- Domains > Domains [Delete single DNS record](https://mijn.host/api/doc/api-4293957.md): Delete a single DNS record from a specific domain. The record is identified by its type, name and value. When the rrset (records sharing the same name + type) contains only the matching value, the entire rrset is removed; when it contains additional values, only the matching value is removed and the remaining values are preserved.
- Domains > Domains [Get auth code](https://mijn.host/api/doc/api-3579762.md): Retrieve the auth-code of specific domain
- Domains > Contacts [List profiles](https://mijn.host/api/doc/api-3563933.md): Retrieve a list of all contact profiles in your account.
- Domains > Contacts [Get profile](https://mijn.host/api/doc/api-3875019.md): Retrieve details of specific contact profile.
- Domains > Contacts [Create profile](https://mijn.host/api/doc/api-3563935.md): Create a new contact profile.
- Domains > Contacts [Update profile](https://mijn.host/api/doc/api-3874523.md): Update profile settings of an existing profile in your account. Optional fields left empty will not be updated.
- Domains > Contacts [Delete profile](https://mijn.host/api/doc/api-4045505.md): Delete existing contact profile by ID.
- Domains > Contacts [Get profile](https://mijn.host/api/doc/api-4146652.md): Retrieve details of specific contact profile.
- Domains > Contacts [Update profile](https://mijn.host/api/doc/api-4146653.md): Update profile settings of an existing profile in your account. Optional fields left empty will not be updated.
- Domains > Nameservers [List profiles](https://mijn.host/api/doc/api-3563938.md): Retrieve a list of all nameserver profiles in your account.
- Domains > Nameservers [Get profile](https://mijn.host/api/doc/api-3875037.md): Retrieve details of specific nameserver profile.
- Domains > Nameservers [Create profile](https://mijn.host/api/doc/api-3563940.md): Create a new nameserver profile.
- Domains > Nameservers [Update profile](https://mijn.host/api/doc/api-3563943.md): Update a nameserver profile.
- Domains > Nameservers [Delete profile](https://mijn.host/api/doc/api-4045506.md): Delete existing nameserver profile by alias.
- Domains > DNS templates [List templates](https://mijn.host/api/doc/api-3563937.md): Retrieve a list of all DNS templates in your account.
- Domains > DNS templates [Get template](https://mijn.host/api/doc/api-3891085.md): Retrieve details of specific DNS template.
- Domains > DNS templates [Create template](https://mijn.host/api/doc/api-3891050.md): Create a new DNS template.
- Domains > DNS templates [Update template](https://mijn.host/api/doc/api-3891083.md): Update a DNS template.
- Domains > DNS templates [Delete template](https://mijn.host/api/doc/api-4045507.md): Delete existing contact template by ID.
- Domains > Availability [Check domain availability](https://mijn.host/api/doc/api-3563904.md): Retrieve all domains from your account
- Domains > Order [Order domain](https://mijn.host/api/doc/api-3563905.md): Transfer or register a domain. Be careful with this command as the order will be executed directly and your account will be charged.
- Domains > Extensions [List domain extensions](https://mijn.host/api/doc/api-4203323.md): Lists domain extensions (TLDs) with register, renew, and transfer prices (optional `search`).
- Domains > Extensions [Get domain extension](https://mijn.host/api/doc/api-4203324.md): Returns pricing, features, and registry requirements for one domain extension (`extension` path = TLD).
- Virtual Private Servers > Backups [List backups](https://mijn.host/api/doc/api-4144531.md): List available backups for the VPS.
- Virtual Private Servers > Backups [Create backup](https://mijn.host/api/doc/api-4146654.md): Create a new backup (snapshot) of the VPS. Creation runs in the background; use `GET /vps/{id}` to check progress (`details.tasks`, `details.vps_locked`).
- Virtual Private Servers > Backups [Restore backup](https://mijn.host/api/doc/api-4146655.md): Restore the VPS from a backup. Use the `key` from the backups list. Restore runs in the background; use `GET /vps/{id}` to check progress (`details.tasks`, `details.vps_locked`).
- Virtual Private Servers [List VPS instances](https://mijn.host/api/doc/api-4144516.md): List Virtual Private Server instances. Use each `id` with the other VPS endpoints.
- Virtual Private Servers [VPS details](https://mijn.host/api/doc/api-4146643.md): Get details of a single VPS (overview as in the control panel) including specifications, network, and status (`details.tasks`, `details.vps_locked`).
- Virtual Private Servers [Update VPS](https://mijn.host/api/doc/api-4146676.md): Update VPS properties. Supports IP/reverse DNS (PTR) updates via the `ip-addresses` array in the JSON body.
- Virtual Private Servers [Restart VPS](https://mijn.host/api/doc/api-4144527.md): Restart the VPS.
- Virtual Private Servers [Enable or disable rescue mode](https://mijn.host/api/doc/api-4144526.md): Enable or disable rescue mode. When enabling, the VPS is restarted in rescue mode and a temporary admin password is returned.
- Virtual Private Servers [Cancel VPS](https://mijn.host/api/doc/api-4144522.md): Cancel a VPS. The VPS will be cancelled and will stop at the end of the billing period.
- Virtual Private Servers [Cancel VPS deletion](https://mijn.host/api/doc/api-4144520.md): Cancel the deletion of a VPS. The VPS will be restored to active.
- Virtual Private Servers [List available OS images](https://mijn.host/api/doc/api-4144523.md): List available OS images for VPS reinstall. Use an `id` from this list as `image_id` on `POST /vps/{id}/reinstall`.
- Virtual Private Servers [Reinstall VPS](https://mijn.host/api/doc/api-4144525.md): Reinstall the VPS with the given OS image. A new root password is generated and returned. To restore from a backup instead, use `PATCH /vps/{id}/backups`.
- Orders [List orders](https://mijn.host/api/doc/api-4048360.md): Retrieve all open orders in account.
- Orders [Get order](https://mijn.host/api/doc/api-4048362.md): Retrieve details of a specific open order.
- Orders [Update order](https://mijn.host/api/doc/api-4048367.md): Update a specific order's `cart` item and process the order again.
- Affiliate > Commissions [List affiliate commissions](https://mijn.host/api/doc/api-4189517.md): Paginated affiliate commissions for your account (`page`, `limit`, optional `search`). Use `GET /affiliate/commissions/{id}` for the full record, including any rejection reason when a commission was not approved.
- Affiliate > Commissions [Get affiliate commission](https://mijn.host/api/doc/api-4189518.md): Full detail for one affiliate commission on your account.
- Affiliate > Payments [List affiliate payments](https://mijn.host/api/doc/api-4189519.md): Paginated affiliate payouts (`page`, `limit`, optional `search`); each row includes an `invoice_nr` for the linked invoice.
- Affiliate > Payments [Get affiliate payment](https://mijn.host/api/doc/api-4189520.md): Detail for one affiliate payout on your account.
- Account > Profile [Get account profile](https://mijn.host/api/doc/api-4203325.md): Account profile: name, address, phone, emails, company/VAT. `company` and `account_type` are read-only in this endpoint.
- Account > Profile [Update account profile](https://mijn.host/api/doc/api-4203326.md): Replaces your profile with the JSON body (same fields as `GET /account/profile/`). Any key you omit is cleared to empty, except only `email_invoices` and `company_vat_number` may be omitted or null. Changing `email` triggers a verification message instead of updating the address immediately.
- Account > Payment methods [List payment methods](https://mijn.host/api/doc/api-4203327.md): Bank transfer and/or other provider methods (SEPA, card, …). Each item has an `id`: use it as `default_paymethod_id` on `PUT /account/paymethods/`, or send `paymethod`: `bank_transfer` to prefer bank transfer.
- Account > Payment methods [Update default payment method](https://mijn.host/api/doc/api-4203328.md): Set `default_paymethod_id` to an `id` from `GET /account/paymethods/`, or `paymethod`: `bank_transfer` for bank transfer.
- Account > Invoices [List invoices](https://mijn.host/api/doc/api-4203329.md): Paginated invoices (`page`, `limit`, optional `search`) with `payment_status` and `payment_url` when unpaid.
- Account > Invoices [Get invoice](https://mijn.host/api/doc/api-4203330.md): Returns invoice details for the display `invoice_nr` in the path. Download the PDF with `GET /account/invoices/{invoice_nr}/pdf` using the same `Api-Key`.
- Account > Invoices [Download invoice PDF](https://mijn.host/api/doc/api-4203331.md): Download the invoice PDF. Response is `application/pdf`.
- Account > Users [List account users](https://mijn.host/api/doc/api-4203332.md): Paginated list of sub-users on the account (`page`, `limit`, optional `search`).
- Account > Users [Get account user](https://mijn.host/api/doc/api-4203333.md): Returns one sub-user (`id` in the path) with their permissions. `is_main_user` marks the primary account contact.
- Account > Users [Create account user](https://mijn.host/api/doc/api-4203334.md): Creates a sub-user for the account. Limited to 10 new users per account per hour.
- Account > Users [Update account user](https://mijn.host/api/doc/api-4203335.md): Updates first and last name for sub-user `id` in the path. For non-primary users, an optional `permissions` object replaces the full set; omit it to leave permissions unchanged.
- Account > Tickets [List support tickets](https://mijn.host/api/doc/api-4203336.md): Paginated list of your support tickets (`page`, `limit`, optional `search`; rows include `ticket_number`, `subject`, `status`, last updated, creator). `search` matches `subject` or `ticket_number` (partial). Newest activity first.
- Account > Tickets [Get support ticket](https://mijn.host/api/doc/api-4203337.md): Returns `subject`, `status`, and the full `thread` for `ticket_number` in the path. Message bodies use HTML; embedded images are removed.
- Account > Tickets [Create support ticket](https://mijn.host/api/doc/api-4203338.md): Creates a support ticket. `department` must be one of: `support`, `administration`, `sales`, `public_cloud`, `microsoft_365`. Optional `product_type`, `product_name`, and `product_link` add context.
- Account > Tickets [Reply to support ticket](https://mijn.host/api/doc/api-4203339.md): Adds your reply to `ticket_number` in the path when the ticket belongs to your account. File attachments are not supported.