Skip to content
Documentation/API reference
API · domains

Detect DNS provider

GET /api/v2/domains/{id}/provider

Authorization

Owner/admin user session (use inboxit login). Use the CLI login flow; a workspace API key cannot call this operation.

Parameters

All resource access is checked against the selected workspace and user permissions.

NameTypeContract
idpath · requiredResource UUID

Request

Run inboxit login first. The CLI supplies authenticated user credentials.

Example
inboxit domains provider --id RESOURCE_UUID

Response

HTTP 200. Example values are illustrative; excerpts are marked.

Example
{
  "provider": null,
  "nameservers": [],
  "zone": null,
  "status": "unknown"
}

Behavior & errors

Best-effort lookup: status is found, unknown or unavailable. Detected provider has name and url; nameservers is a string array and zone is the resolved zone. Does not edit DNS. Use the dashboard or inspect the returned result for provider navigation. Common errors: 400 invalid input, 401 unauthenticated, 403 insufficient permission, 404 missing/inaccessible resource, 409 conflict, 429 rate/usage limit, 503 service unavailable. See Errors & retries for recovery guidance.