How domain registration works
What happens when you register or transfer a domain with Coritan, how prices are set, and what each registration status means.
In the dashboard
Coritan registers domains for you with each extension's registry, renews them and hands them over when you move them elsewhere. A domain you register or transfer here is a registration on your account. Its DNS can be hosted on Coritan or anywhere else, because the registration only says which nameservers answer for the domain. The public Domains page describes the product, and each extension's price shows in the dashboard when you search for a name.
Terms
Section titled Terms- Registration
- Your right to a domain for the period you pay for, 1–10 years at a time, held through Coritan.
- Registry
- The organization that runs a domain extension, such as
.com. Coritan passes your changes to it. - Nameservers
- The servers the registry sends resolvers to for the domain. A domain registered here starts on Coritan's nameservers,
ns1.coritan.comtons8.coritan.com. - EPP code
- A secret the current registrar gives you so another registrar can take the domain over. It is also called an auth code.
- Transfer lock
- A registry setting that refuses transfer requests while it is on.
Prices
Section titled PricesThe dashboard shows a domain's price per year when you search for it. A premium domain has a price that its registry sets. View domain prices, in the Domain Management list's More website actions menu, lists what each extension costs per year to register, renew and transfer. A registration takes the price for the whole period from your account credit before Coritan registers the domain, and gives it back when the registration fails.
Every price in the list is our price, the one we charge. Coritan refreshes the list from its registrar once a day. A renewal costs the extension's renewal price for each year, and a transfer its transfer price, as the list shows them. A registration costs the registrar's price for the name at the same rate as the list, so for an ordinary name it is the listed registration price, and a premium name costs what a search shows. Renewals and transfers are paid from your credit the same way, before Coritan asks the registry, and Coritan gives the charge back when the registry refuses. For an extension the list does not show, Coritan charges the price per year that a search shows. The domain order page and the renewal page show the price before you confirm, and they add credit with your card when your balance is short.
If your account's currency is not US dollars, the dashboard shows each of these prices in it as an estimate, worked out from the US dollar price at the current exchange rate (Prices in your currency). A domain is always paid from your account credit, which is in US dollars, so what Coritan takes from it is in US dollars. A card that adds credit when yours is short is charged in your currency. The domain endpoints below answer in US dollars. A domain ordered through checkout on a yearly subscription is the exception: the subscription's invoices pay for its renewals (Domains that renew with their service).
What registering sets up
Section titled What registering sets upA new registration starts with the transfer lock, auto-renew and WHOIS privacy on, unless you turn WHOIS privacy off when you register. It starts on Coritan's nameservers, with a DNS zone on your account. The dashboard also offers to issue a certificate and to set up a web proxy for the domain. Register a domain describes each option.
Statuses
Section titled StatusesThe status appears beside the domain in the Domain Management list and on its Settings tab. The API sends these words:
| Status | Meaning |
|---|---|
active |
The domain is registered and you can change its settings. |
expiring_soon |
The domain expires in fewer than 30 days. |
expired |
The registry reports the domain as expired. |
pending_transfer |
You started a transfer to Coritan and it has not completed. |
Coritan reads each registration back from its registry regularly, and updates its status, expiry date, nameservers and switches from what the registry holds. A change made at the registry shows in the dashboard after that read.
Important
The dashboard renews a registration while it is active or expiring_soon. It changes the switches, the nameservers and the EPP code only while the registration is active. Contact support for a change the dashboard cannot make.
Renewal and expiry
Section titled Renewal and expiryWith auto-renew on, Coritan renews the domain for one year when it is within 14 days of its expiry date, and takes the price from your credit first. When your credit does not cover it, Coritan renews nothing, emails you, and tries again each day until the domain expires. With auto-renew off, Coritan emails you 30, 14, 7, 3 and 1 day before the domain expires. A domain ordered through checkout on a yearly subscription renews for a year once you pay the subscription's renewal invoice. Renew a domain covers all three.
Read registrations with the API
Section titled Read registrations with the APIList your registrations, newest first, with an access token (Authentication). The list takes page, per_page (25 by default, up to 100) and status, which keeps only registrations with that status word:
curl "https://api.coritan.com/api/v1/domains/registrations?status=active" \
-H "Authorization: Bearer $CORITAN_TOKEN"
{
"registrations": [
{
"id": 7,
"domain": "example.com",
"status": "active",
"registered_at": "2026-09-16T10:04:00Z",
"expires_at": "2027-09-16T10:04:00Z",
"nameservers": ["ns1.coritan.com", "ns2.coritan.com"],
"whois_privacy": true,
"locked": true,
"auto_renew": true,
"dns_zone_id": 42,
"proxy_route_id": null,
"ssl_certificate_id": null
}
],
"total": 1
}
GET /api/v1/domains/registrations/{reg_id} returns one registration in the same shape, or 404 with Registration not found. It adds two fields: service_id, the service the domain was ordered with or null, and renews_with_service, which is true when that service's invoices pay for the renewals because it bills a year or more at a time. Such a domain cannot be renewed from credit, and its renew route answers 409. GET /api/v1/domains/pricing returns the price list, one entry per extension, sorted by extension:
[
{"tld": "com", "register_price": "14.99", "renew_price": "16.99", "transfer_price": "14.99", "currency": "USD"}
]
The figures in this example only show the shape. The endpoint returns the current prices, as strings, and transfer_price is null for an extension that has none.
GET /api/v1/domains/prices needs no sign-in and returns the same prices for anyone. Each entry has the extension with its dot, register, renew, transfer and restore as strings with two decimals (restore is null when the registrar names none), min_years and max_years for one purchase, and on_sale for a limited registration offer. updated_at says when the list was last refreshed. Until the first refresh, the list holds the common extensions only and updated_at is null:
curl "https://api.coritan.com/api/v1/domains/prices"
{
"currency": "USD",
"tlds": [
{"tld": ".com", "register": "14.99", "renew": "16.99", "transfer": "14.99", "restore": "150.00", "min_years": 1, "max_years": 10, "on_sale": false}
],
"updated_at": "2026-10-12T05:30:04"
}
Related
Section titled RelatedAPI operations on this page
| Method | Path | What it does |
|---|---|---|
GET | /api/v1/domains/prices | What a year of each domain extension costs |
GET | /api/v1/domains/pricing | Get available TLD pricing |
GET | /api/v1/domains/registrations | List user's domain registrations |
GET | /api/v1/domains/registrations/{reg_id} | Get details of a specific domain registration |