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

# Get namespace detail

> Returns full detail for a namespace: components with statuses, active incidents, and scheduled maintenances.



## OpenAPI

````yaml https://sandbox-api.borderless.xyz/v1/api-json get /v1/network-health/{namespace}
openapi: 3.0.0
info:
  title: Borderless API
  description: The Borderless API documentation.
  version: '1.0'
  contact: {}
servers:
  - url: https://sandbox-api.borderless.xyz
security: []
tags: []
paths:
  /v1/network-health/{namespace}:
    get:
      tags:
        - Network Health
      summary: Get namespace detail
      description: >-
        Returns full detail for a namespace: components with statuses, active
        incidents, and scheduled maintenances.
      operationId: NetworkHealthController_getNamespaceDetail
      parameters:
        - name: namespace
          required: true
          in: path
          schema:
            example: Bridge
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NetworkHealthNamespaceDetailEntity'
      security:
        - bearer: []
components:
  schemas:
    NetworkHealthNamespaceDetailEntity:
      type: object
      properties:
        namespace:
          type: string
        overallStatus:
          allOf:
            - $ref: '#/components/schemas/ComponentStatus'
        components:
          type: array
          items:
            $ref: '#/components/schemas/NetworkHealthComponentEntity'
        incidents:
          description: Active incidents (non-resolved)
          type: array
          items:
            $ref: '#/components/schemas/NetworkHealthIncidentEntity'
        maintenances:
          description: Scheduled or in-progress maintenances
          type: array
          items:
            $ref: '#/components/schemas/NetworkHealthIncidentEntity'
      required:
        - namespace
        - overallStatus
        - components
        - incidents
        - maintenances
    ComponentStatus:
      type: string
      enum:
        - Operational
        - DegradedPerformance
        - PartialOutage
        - MajorOutage
        - UnderMaintenance
      description: Worst status across all components
    NetworkHealthComponentEntity:
      type: object
      properties:
        id:
          type: string
        namespace:
          type: string
        name:
          type: string
        description:
          type: string
        status:
          allOf:
            - $ref: '#/components/schemas/ComponentStatus'
        order:
          type: number
        manual:
          type: boolean
        hidden:
          type: boolean
        createdAt:
          format: date-time
          type: string
        updatedAt:
          format: date-time
          type: string
      required:
        - id
        - namespace
        - name
        - status
        - order
        - manual
        - hidden
        - createdAt
        - updatedAt
    NetworkHealthIncidentEntity:
      type: object
      properties:
        id:
          type: string
        namespace:
          type: string
        title:
          type: string
        status:
          allOf:
            - $ref: '#/components/schemas/IncidentStatus'
        impact:
          allOf:
            - $ref: '#/components/schemas/IncidentImpact'
        manual:
          type: boolean
        startedAt:
          format: date-time
          type: string
        resolvedAt:
          format: date-time
          type: string
        sourceUrl:
          type: string
        components:
          type: array
          items:
            $ref: '#/components/schemas/IncidentComponentEntity'
        updates:
          description: Events linked to this incident
          type: array
          items:
            $ref: '#/components/schemas/NetworkHealthUpdateEntity'
        createdAt:
          format: date-time
          type: string
      required:
        - id
        - namespace
        - title
        - status
        - impact
        - manual
        - startedAt
        - components
        - updates
        - createdAt
    IncidentStatus:
      type: string
      enum:
        - Investigating
        - Identified
        - Monitoring
        - Resolved
    IncidentImpact:
      type: string
      enum:
        - None
        - Minor
        - Major
        - Critical
        - Maintenance
    IncidentComponentEntity:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      required:
        - id
        - name
    NetworkHealthUpdateEntity:
      type: object
      properties:
        id:
          type: string
        incidentId:
          type: string
        message:
          type: string
        status:
          allOf:
            - $ref: '#/components/schemas/IncidentStatus'
        reportedAt:
          format: date-time
          type: string
      required:
        - id
        - status
        - reportedAt
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````