DOCUMENTATION

Build on SomDNS

Everything the platform can do is available over the API — the dashboard is just one client. These pages cover the paths most people need first.

Quickstart

Create an API token in Dashboard → Security → API keys, then talk to the API. Tokens are scoped per product and can be restricted by IP.

bash
curl https://api.somdns.com/v1/domains \
  -H "Authorization: Bearer $SOMDNS_TOKEN"

DNS records

Anycast DNS is included with every domain. Changes propagate to all 14 edge nodes in under 30 seconds. These are the record types the resolver supports.

Type Use it for Min TTL
A / AAAAPoint a hostname at an IP60s
CNAMEAlias one hostname to another60s
MXRoute mail to a mail host300s
TXTSPF, DKIM, DMARC, verification60s
SRVService discovery (SIP, XMPP)300s
CAARestrict which CAs may issue certs3600s

REST API

JSON over HTTPS, cursor paginated, rate limited to 600 requests per minute per token. Every mutating call accepts an Idempotency-Key header.

GET /v1/domains/{domain}/availability
POST /v1/orders
POST /v1/zones/{zone}/records
DELETE /v1/servers/{id}
javascript
const res = await fetch(
  "https://api.somdns.com/v1/domains/ayaan.so/availability",
  { headers: { Authorization: `Bearer ${token}` } }
);

const { available, price } = await res.json();
// -> { available: true, price: 15.00, currency: "USD" }

Domain transfers

Transfers add a full year to your registration at the transfer price. Most complete within an hour; gTLDs can take up to five days if the losing registrar delays approval.

  1. 1Unlock the domain at your current registrar and disable WHOIS privacy.
  2. 2Request the EPP / auth code — it is emailed to the registrant address.
  3. 3Start the transfer in SomDNS and paste the code.
  4. 4Approve the confirmation email. We copy your existing DNS records first, so nothing goes dark.

Integrations

First-party integrations maintained by our team. Anything missing can be built on the REST API or driven by webhooks.

Terraform provider
Declare zones, records and servers as code.
Webhooks
Signed events for orders, renewals and incidents.
GitHub Actions
Deploy to hosting or a VPS on every push.
Grafana & Prometheus
Scrape server and DNS metrics into your stack.

Platform status

Live component health. Incidents are posted here first, then to email and webhooks.

Support

Real engineers, 24/7, in Somali, Arabic and English. Enterprise plans get a named contact and a 15-minute response target.

Live chat
Median first reply: 2 minutes
Tickets
support@somdns.com · 24/7
Phone
+252 61 000 0000