Skip to main content
    REST API v1

    API Reference

    Build powerful domain management features into your applications

    Quick StartView Endpoints

    Quick Start

    Get started with the RollDomains API in minutes. All API requests require authentication using a Bearer token.

    Base URL

    https://api.rolldomains.com

    Example: Search Domain Availability

    Check if a domain is available for registration across multiple TLDs

    curl -X POST https://api.rolldomains.com/api/domains/search \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example",
    "tlds": ["com", "net", "io"]
  }'

    Authentication

    All API requests must include an Authorization header with a valid Bearer token. You can obtain tokens by calling the login endpoint or through OAuth.

    Authorization: Bearer YOUR_API_TOKEN

    API Endpoints

    Authentication

    POST
    /api/auth/login
    POST
    /api/auth/register
    POST
    /api/auth/refresh
    POST
    /api/auth/logout

    Domains

    GET
    /api/domains
    GET
    /api/domains/:id
    POST
    /api/domains/search
    POST
    /api/domains/register
    POST
    /api/domains/transfer
    POST
    /api/domains/:id/renew
    PUT
    /api/domains/:id/settings
    PUT
    /api/domains/:id/nameservers

    DNS

    GET
    /api/dns/:domainId/records
    POST
    /api/dns/:domainId/records
    PUT
    /api/dns/:domainId/records/:recordId
    DELETE
    /api/dns/:domainId/records/:recordId

    Orders

    GET
    /api/orders
    GET
    /api/orders/:id
    POST
    /api/orders

    Webhooks

    POST
    /api/webhooks/stripe
    POST
    /api/webhooks/domain-events

    Rate Limits

    To ensure fair usage, the API enforces rate limits. If you exceed the limit, you'll receive a 429 Too Many Requests response.

    100
    Requests per 15 min
    Standard endpoints
    10
    Requests per 15 min
    Auth endpoints
    1000
    Requests per 15 min
    Reseller accounts