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

# Check Domain Availability

> Check if a domain is available for tracking before creating an entity. Returns whether the domain is available, already in your workspace, or tracked by another user.



## OpenAPI

````yaml get /entities/check-domain
openapi: 3.1.0
info:
  title: Geogen API
  description: >-
    API for accessing LLM visibility data, managing entities, and tracking AI
    mentions.
  version: 1.0.0
servers:
  - url: https://api.geogen.io/v1
    description: Production server
security:
  - bearerAuth: []
paths:
  /entities/check-domain:
    get:
      tags:
        - Entities
      summary: Check Domain Availability
      description: >-
        Check if a domain is available for tracking before creating an entity.
        Returns whether the domain is available, already in your workspace, or
        tracked by another user.
      operationId: checkDomainAvailability
      parameters:
        - name: domain
          in: query
          required: true
          schema:
            type: string
          description: Domain to check (e.g., example.com or https://example.com)
      responses:
        '200':
          description: Domain availability check result
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  available:
                    type: boolean
                    description: Whether the domain is available for tracking
                  reason:
                    type: string
                    enum:
                      - not_tracked
                      - already_in_workspace
                      - tracked_by_another_user
                    description: Reason for the availability status
                  message:
                    type: string
                    description: Human-readable explanation
              examples:
                available:
                  summary: Domain is available
                  value:
                    success: true
                    available: true
                    reason: not_tracked
                    message: This domain is available for tracking.
                already_tracked:
                  summary: Domain already in workspace
                  value:
                    success: true
                    available: false
                    reason: already_in_workspace
                    message: This domain is already tracked in your workspace.
                taken:
                  summary: Domain tracked by another user
                  value:
                    success: true
                    available: false
                    reason: tracked_by_another_user
                    message: This domain is already being tracked by another user.
        '400':
          description: Missing domain parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  retryAfter:
                    type: number
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key authentication. Format: Bearer wsk_your_api_key'

````