Copy page

Introduction

Introduction

RESTful API for managing domain registrations across multiple registrars through a single unified interface.

The Most API lets you search domain availability, register domains in bulk across providers like Spaceship, Dynadot, Webnic, GName, and NiceNIC, and track the registration pipeline through a single tracking token per batch.

Base URL

All API requests are made to:

Code
https://api.most.ac/v1

Authentication

All endpoints require a bearer token in the Authorization header. Generate your token in the console under Settings → Personal account → API Tokens.

Code
curl https://api.most.ac/v1/domains \
  -H "Authorization: Bearer bk_your_token_here"

Tokens start with bk_ followed by 64 hex characters. Each token can be restricted to a list of allowed IP addresses — requests from other IPs return 403 Forbidden.

Response Envelope

All successful responses share the same JSON envelope:

Code
{
  "success": true,
  "data": { }
}

Errors return:

Code
{
  "success": false,
  "error": {
    "code": "BAD_REQUEST",
    "message": "Maximum 35 domains per search request."
  }
}

Pagination

List endpoints support limit (1–100, default 20) and offset (default 0) query parameters. The response includes a total field with the full count.

Code
GET /v1/domains?limit=50&offset=100

Rate Limits

Each API token has a default rate limit of 10 requests per second, enforced as a fixed 1-second window per token. Exceeding the limit returns 429 Too Many Requests — wait less than a second and retry. Need more throughput? Ask an admin to raise the rateLimit column on your token; the enforcement logic doesn't cap higher values.

All clients sharing the same token share the same bucket, so if you run parallel workers against one token you need to coordinate yourself or split the load across multiple tokens.

Async Tasks

Bulk operations (renew, set nameservers, fetch EPP codes) run asynchronously. Instead of processing inline they create a Task and return a taskId immediately:

Code
curl -X POST https://api.most.ac/v1/domains/renew \
  -H "Authorization: Bearer bk_..." \
  -d '{"items":[{"domainId":"cm_...","term":1}]}'

# → { "success": true, "data": { "taskId": "cm_task_...", "total": 1 } }

Poll the task to see progress:

Code
curl https://api.most.ac/v1/tasks/cm_task_... \
  -H "Authorization: Bearer bk_..."

# → status: PENDING → RUNNING → COMPLETED | FAILED | PARTIAL

A task is COMPLETED when all items succeeded, FAILED when all failed, or PARTIAL when only some succeeded. Per-item outcomes live in task.result.

For real-time notifications subscribe to task.completed via webhooks — the task is posted to your webhook URL when it's done.

Webhooks

Instead of polling task endpoints, subscribe to real-time notifications. Configure your webhook URL in Settings → Personal account → Webhook and Most will POST events like task.completed, orders.registered, orders.completed, balance.low, domain.expiring, domain.deleting, and domain.blocked.

See the Webhooks guide for the full list of events, payload examples, and retry policy.

Next Steps

• API Reference — explore all endpoints
• Webhooks — real-time event notifications