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

# Get domain

> Retrieve details of a specific domain (Expert Plan required)



## OpenAPI

````yaml openapi.yaml get /v2/domains/{uuid}
openapi: 3.0.3
info:
  title: PulseGuard API
  description: >
    Comprehensive monitoring and management API for domains, devices, services,
    and network utilities.


    ## Authentication


    PulseGuard API uses different authentication methods depending on the
    endpoint:


    - **Bearer Token**: Most API endpoints require a valid API token passed in
    the Authorization header

    - **Agent Authentication**: Device agent endpoints use device-specific
    tokens

    - **Public Access**: Some endpoints like domain checking and downloads are
    publicly accessible


    ## Rate Limiting


    API requests are rate-limited per user and endpoint. Rate limits vary by
    subscription plan.


    ## Plan Requirements


    Certain API endpoints require specific subscription plans:

    - **Expert Plan**: Full API v1 access with advanced features

    - **Reports Plan**: Access to comprehensive reporting data

    - **Free/Pro Plans**: Basic monitoring with limited API access


    ## Base URL


    **Production**: `https://api.ipulse.one`


    ## Support


    For API support, visit our [documentation](https://docs.ipulse.one) or
    contact us at info@ipulse.one.
  version: 1.0.0
  contact:
    name: PulseGuard Support
    url: https://docs.ipulse.one
    email: info@ipulse.one
  license:
    name: Proprietary
    url: https://ipulse.one/terms
servers:
  - url: https://api.ipulse.one
    description: Production server
security:
  - bearerAuth: []
  - agentAuth: []
tags:
  - name: Authentication
    description: User authentication and account management
  - name: Domains
    description: Domain monitoring and management (Expert Plan required)
  - name: Devices
    description: Device monitoring and management (Expert Plan required)
  - name: Service Monitors
    description: Service monitoring endpoints (Expert Plan required)
  - name: Toolbox
    description: Network utility tools (Expert Plan required)
  - name: Statistics
    description: Analytics and statistics (Expert Plan required)
  - name: AI & Anomalies
    description: AI-powered anomaly detection and management
  - name: Reports
    description: Comprehensive reporting (Reports Plan required)
  - name: Public
    description: Publicly accessible endpoints
paths:
  /v2/domains/{uuid}:
    get:
      tags:
        - Domains
      summary: Get domain
      description: Retrieve details of a specific domain (Expert Plan required)
      parameters:
        - $ref: '#/components/parameters/DomainUUID'
      responses:
        '200':
          description: Domain retrieved successfully
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Success'
                  - type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/Domain'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    DomainUUID:
      in: path
      name: uuid
      required: true
      schema:
        type: string
        format: uuid
      description: Domain UUID
  schemas:
    Success:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          description: Success message
        data:
          oneOf:
            - type: object
              description: Response data as object
            - type: array
              description: Response data as array
      required:
        - success
        - message
    Domain:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
          description: Unique identifier for the domain
        name:
          type: string
          description: Domain name (e.g., example.com)
        url:
          type: string
          format: uri
          description: Full URL to monitor
        status:
          type: string
          enum:
            - up
            - down
            - maintenance
            - unknown
          description: Current domain status
        response_time:
          type: number
          format: float
          description: Latest response time in milliseconds
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - uuid
        - name
        - url
        - status
    Error:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          description: Error message
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Validation errors (if applicable)
      required:
        - success
        - message
  responses:
    Unauthorized:
      description: Unauthorized - Invalid or missing API token
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            success: false
            message: Unauthenticated.
    Forbidden:
      description: Forbidden - Insufficient permissions or plan requirements not met
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            success: false
            message: This feature requires an Expert Plan subscription.
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            success: false
            message: Resource not found.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: token
      description: API token generated from your PulseGuard dashboard
    agentAuth:
      type: http
      scheme: bearer
      bearerFormat: token
      description: Device agent authentication token

````