v1 JSON REST

Odrim Domain API

Check .com domain availability programmatically. Free tier supports IP-based checks; paid plans use API keys for bulk checks and keyword search.

1. Authenticate Bearer API key or free IP tier 2. Check a domain GET /v1/check in milliseconds 3. Try the playground Run live requests in-browser

Authentication

Paid plans require an API key on every request:

Authorization: Bearer YOUR_API_KEY

Create keys at Dashboard → API Keys. Keys start with odr_live_ and are shown only once at creation.

Free tier: GET /v1/check works without a key (IP rate limit applies).

Base URL

https://app.odrim.com

All v1 routes are prefixed with /v1.

Rate limits

Daily quotas reset at midnight UTC. Responses include:

X-RateLimit-Remaining — requests left today
X-RateLimit-Reset — next reset (ISO 8601)

When exceeded, the API returns 429 with retry_after in the JSON body.

Plan	Requests/day	Bulk limit	RPS
Free (IP)	500	—	1
Starter	5,000	500	5
Pro	50,000	5,000	20
Enterprise	500,000+	50,000	100

Endpoints

Method	Path	Auth	Description
GET	/v1/check	Key or IP	Single domain check
POST	/v1/bulk	Paid key	Up to plan bulk limit
POST	/v1/search	Paid key	Keyword combinations
GET	/v1/me	Key	Account info
GET	/v1/usage	Key	Quota snapshot

Check domain

GET /v1/check

Check one domain (label with or without .com).

Query parameters

Name	Type	Required	Description
domain	string	yes	Domain label, e.g. `example`

Response

{
  "domain": "example.com",
  "available": true,
  "checked_at": "2026-05-17T12:00:00Z",
  "quota": {
    "used_today": 42,
    "limit_today": 5000,
    "resets_at": "2026-05-18T00:00:00Z"
  }
}

Bulk check

POST /v1/bulk

Starter+ — check multiple domains in one request.

Request body

{"domains": ["foo", "bar", "mybrand"]}

Response

{
  "results": [{"domain": "foo.com", "available": false}],
  "checked": 3,
  "elapsed_ms": 12.4,
  "quota": { "used_today": 100, "limit_today": 5000, "resets_at": "..." }
}

Keyword search

POST /v1/search

Starter+ — keyword combination search against the zone file.

{
  "keyword": "ai",
  "filter": "available",
  "pos": "prefix"
}

filter: all | available | taken · pos: all | prefix | suffix

Account

GET /v1/me

Returns account email, plan, and API key prefix.

Usage

GET /v1/usage

Returns current quota usage for the API key.

Error responses

Errors use a consistent JSON shape:

{"error": "rate_limited", "message": "Daily limit reached", "retry_after": "2026-05-18T00:00:00Z"}

HTTP	error	Meaning
400	invalid_request	Bad parameters or bulk over limit
401	unauthorized	Missing or invalid API key
403	forbidden	Plan not allowed (e.g. free on bulk)
429	rate_limited	Quota or RPS exceeded
503	service_unavailable	Redis zone loading

Changelog

2026-05-17 — v1.0.0

Initial public API: check, bulk, search, me, usage
Free IP tier for single checks
Rate limit headers on all authenticated routes

Playground

Send a live request from your browser. Your API key is stored locally only.

Try GET /v1/check

Loading session…

API key

Domain

Response will appear here.