domainawait API

Getting started

Most endpoints are public and require no authentication. To create or modify your own data, you'll need a personal access token.

1. Sign in at https://app.domainawait.com.
2. Visit Settings → API keys and create a token.
3. Send it as a Bearer token in the Authorization header.

Authentication

Authenticated requests use a Bearer token:

Authorization: Bearer YOUR_TOKEN

Web sessions (used by the dashboard) are cookie-based via Sanctum SPA auth. Third-party integrations should always use a personal access token.

Rate limits

• Public endpoints

  60 / min

  Per IP address.

• Authenticated endpoints

  120 / min

  Per user or token.

Exceeding the limit returns HTTP 429 with a Retry-After header.

Public

• GET/v1/domains/{name}

  Fetch a domain's public details: expiration, follower count, and check history.

• GET/v1/domains/trending

  List domains sorted by follower count. Supports ?limit=N (1-100).

Auth

• POST/v1/auth/magic-link

  Request a magic link via email. Body: { email }.

• GET/v1/auth/magic-link/verify

  Verify a magic link token from the email.

• GET/v1/auth/google/redirect

  Start the Google OAuth flow.

• GET/v1/auth/google/callback

  Google OAuth callback.

• POST/v1/auth/logout

  Log out the current session.

  Auth
• GET/v1/auth/me

  Return the authenticated user.

  Auth

Domains (authenticated)

• POST/v1/domains

  Add a domain to your watchlist. Body: { name, notify_days_before? }.

  Auth
• GET/v1/domains/me

  List the domains you are tracking.

  Auth
• PATCH/v1/domains/me/{id}

  Update reminder preferences for a subscription.

  Auth
• DELETE/v1/domains/me/{id}

  Unsubscribe from a domain.

  Auth

API tokens

• POST/v1/tokens

  Create a personal access token.

  Auth
• GET/v1/tokens

  List your active tokens.

  Auth
• DELETE/v1/tokens/{id}

  Revoke a token.

  Auth

Examples

const res = await fetch("https://api.domainawait.com/v1/domains/google.com");
const domain = await res.json();
console.log(domain.follower_count);

curl https://api.domainawait.com/v1/domains/google.com

curl -X POST https://api.domainawait.com/v1/domains \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"example.com","notify_days_before":[30,7,1]}'