API Documentation

Use the Domainio REST API to manage domains programmatically. All endpoints require a scoped API key — generate one from your dashboard.

Base URL: https://staging.domainio.nlAuthorization: Bearer dk_live_…

MCP Integration Guide

Domains

GET/api/user/domains

List domains in account (paginated: page, perPage)

Auth

POST/api/domains/check

Check domain availability

POST/api/domains/register

Auth

GET/api/domains/:id

Get domain details

Auth

PATCH/api/domains/:id/settings

Update domain settings

Auth

DNS

GET/api/domains/:id/dns

List DNS records

Auth

POST/api/domains/:id/dns

Create DNS record

Auth

PATCH/api/domains/:id/dns

Update a DNS record (identified in the request body)

Auth

DELETE/api/domains/:id/dns

Delete a DNS record (identified in the request body)

Auth

Email Forwarding

GET/api/domains/:id/email

List email forwarding rules

Auth

POST/api/domains/:id/email

Create forwarding rule

Auth

DELETE/api/domains/:id/email

Delete a forwarding rule (ruleId in the request body)

Auth

Billing

GET/api/agent/balance

Get account balance + transactions

Auth

POST/api/user/billing/topup

Top up balance

Auth

Agent / MCP

POST/api/agent/api-keys

Generate scoped API key — dashboard session only, 403 for a bearer key

Auth

GET/api/agent/api-keys

List API keys — dashboard session only, 403 for a bearer key

Auth

DELETE/api/agent/api-keys/:id

Revoke API key — dashboard session only, 403 for a bearer key

Auth

POST/api/mcp

MCP server endpoint

Auth

Quick Start

# Check domain availability
curl https://staging.domainio.nl/api/domains/check \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"domain":"yourname.com"}'

# Register a domain (requires API key)
curl https://staging.domainio.nl/api/domains/register \
  -X POST \
  -H "Authorization: Bearer dk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domainName":"yourname.com","years":1,"packageType":"domain_only","contactId":"CONTACT_ID"}'