> ## Documentation Index
> Fetch the complete documentation index at: https://docs.namegrid.org/llms.txt
> Use this file to discover all available pages before exploring further.

# NameGrid: Domain Registration & DNS Management API

> NameGrid is a REST API for domain registration, DNS management, and renewals. Automate your domain workflows programmatically with a single API key.

NameGrid gives you a single REST API to search, register, and manage domains — along with full DNS control — without touching a registrar dashboard. Whether you're building a SaaS platform that provisions domains for customers, automating internal infrastructure, or replacing a manual domain workflow, NameGrid lets you do it all programmatically with predictable credit-based pricing.

## Key capabilities

<CardGroup cols={2}>
  <Card title="Check Availability" icon="magnifying-glass" href="/api-reference/domains/check">
    Query availability for one or more domain names in a single request and detect premium domains before attempting registration.
  </Card>

  <Card title="Register Domains" icon="globe" href="/guides/register-domain">
    Register domains for 1–10 years with optional WHOIS privacy and auto-renewal, all in one API call.
  </Card>

  <Card title="Manage DNS Records" icon="server" href="/guides/manage-dns">
    Create, update, and delete A, CNAME, MX, TXT, and other DNS records with instant propagation.
  </Card>

  <Card title="Renew Domains" icon="arrow-rotate-right" href="/guides/renew-domain">
    Renew domains manually or rely on automatic renewal so registrations never lapse unexpectedly.
  </Card>

  <Card title="Custom Nameservers" icon="network-wired" href="/api-reference/domains/nameservers">
    Point any registered domain at your own nameservers to keep DNS management fully in your stack.
  </Card>

  <Card title="Account & Credits" icon="wallet" href="/api-reference/account/get">
    Check your credit balance and workspace details at any time to keep billing transparent and predictable.
  </Card>
</CardGroup>

## How it works

Every NameGrid action follows the same straightforward pattern:

1. **Generate an API key** in your dashboard at [app.namegrid.org](https://app.namegrid.org).
2. **Make authenticated requests** to `https://api.namegrid.org/v1` by including your key in the `x-api-key` header.
3. **Credits are deducted automatically** whenever you register or renew a domain. One credit equals one dollar, and the exact cost depends on the TLD and registration period. DNS management and availability checks are free.

All responses are JSON. Errors return an `"error"` field with a human-readable message, so your application can handle them programmatically.

## Before you begin

<Note>
  You need a NameGrid account before you can generate an API key or register domains. Sign up for free at [app.namegrid.org](https://app.namegrid.org). Once you're in, head to **Settings → API tokens** to create your first key, then follow the [Quickstart](/quickstart) to make your first request.
</Note>