Documentation / Endpoints / Your usage

Domain API usage: GET /v1/usage

Your usage

How much of your allowance is left this minute and today, without spending any of it.

Free, no keyFree, not counted

GEThttps://api.domainmcp.net/v1/usage

Try itReal answers, not counted

Code

curl "https://api.domainmcp.net/v1/usage"

Parameters

None.

Returns

Every counted answer also carries the same numbers in its headers, so most clients never need this call.

per_minuteinteger

Domains a minute: 60.

used_this_minuteinteger

Used so far this minute.

remaining_this_minuteinteger

Left this minute.

per_dayinteger

Domains a day: 2,000.

used_todayinteger

Used so far today (UTC).

remaining_todayinteger

Left today.

day_resets_atstring

When the day's count goes back to zero.

counted_instring

What is counted: domains checked.

Example answer

GET /v1/usage

{
    "data": {
        "per_minute": 60,
        "used_this_minute": 0,
        "remaining_this_minute": 60,
        "per_day": 2000,
        "used_today": 0,
        "remaining_today": 2000,
        "day_resets_at": "2026-11-12T00:00:00Z",
        "counted_in": "domains checked"
    },
    "meta": {
        "took_ms": 0
    }
}

Errors

unknown_parameter422

This endpoint takes no parameters.

Every error has the same shape. See Errors for all of them.

PreviousPrices by ending NextMCP server