Skip to main content
Use this endpoint to fetch your workspace details and current credit balance. No additional parameters are required — your API key identifies the workspace automatically. This is useful for verifying your available balance before placing orders, since registration and renewal requests will fail with a 402 if your balance is insufficient to cover the cost.

Endpoint

GET /v1/account No path or query parameters are required.

Request Example

Response

200 OK
object
Details about your NameGrid workspace.
object
Your current credit balance information.

Checking Balance Before Actions

Registration and renewal requests fail with a 402 Payment Required error if your credit balance is too low to cover the cost of the operation. Before placing orders in bulk, call this endpoint first to confirm you have enough credits.
Check your balance before registering multiple domains in a single workflow. If your balance runs out mid-batch, earlier registrations will succeed but later ones will fail — leaving you with a partial order that may require manual cleanup.
See the credits overview for a full explanation of how credits work, how to top up your balance, and how costs are calculated for registration and renewal.