# 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. Set nameservers with either `nameserver` (a saved profile alias) or `nameservers` (an explicit hostname list); the two are mutually exclusive. 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): Check domain availability. The response also flags premium (non-standard priced) domains: data.is_premium indicates whether the domain is premium, and data.premium_price carries the premium registration and renewal prices (ex. VAT) when it is, or null otherwise. Use these to detect and display a premium price before ordering; the register amount is what you confirm via accept_premium_price on the order endpoint.
- 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. Premium domains are protected against accidental orders: a premium domain is rejected with status 400 unless accept_premium_price is sent and matches the current premium registration price (ex. VAT) returned by the rejection and by the availability endpoint.
- 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.
- Tools [Get your IP and customer number](https://mijn.host/api/doc/api-4406334.md): Returns the public IP address the request originates from, together with the customer number (klantnummer) the API key belongs to. Useful for discovering which IP to add to an API key whitelist or DNS record, and for correlating API usage with your account/invoices.