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

# Status page data: HelloNear and every service it depends on, checked every 5 minutes

> Public, any origin, no cookies (`access-control-allow-origin: *`, `cache-control: public, max-age=30`). Read by status.hellonear.xyz. See docs/api-contract.md §7.



## OpenAPI

````yaml https://raw.githubusercontent.com/Hellonear-AI/hellonear/main/docs/openapi.json get /v1/status
openapi: 3.1.0
info:
  title: HelloNear API
  version: 1.0.0
  description: >-
    The public HTTP API behind https://app.hellonear.xyz (NEAR testnet). Sign in
    with a NEAR wallet (NEP-413: `/v1/auth/challenge`, then `/v1/auth/login`) or
    start a try-out session with `POST /v1/auth/demo`; both set the `hn_session`
    cookie. Chat, approvals, attack and workflow runs stream server-sent events;
    every event type is described in docs/api-contract.md §3.
servers:
  - url: https://api.hellonear.xyz
    description: Hosted demo (NEAR testnet)
  - url: http://localhost:4000
    description: Local
security:
  - session: []
paths:
  /v1/status:
    get:
      tags:
        - System
      summary: >-
        Status page data: HelloNear and every service it depends on, checked
        every 5 minutes
      description: >-
        Public, any origin, no cookies (`access-control-allow-origin: *`,
        `cache-control: public, max-age=30`). Read by status.hellonear.xyz. See
        docs/api-contract.md §7.
      responses:
        '200':
          description: Current status, 24-hour history and incidents of the last 7 days
          content:
            application/json:
              schema:
                type: object
                required:
                  - updatedAt
                  - overall
                  - services
                  - incidents
                properties:
                  updatedAt:
                    type: string
                    format: date-time
                  overall:
                    type: string
                    enum:
                      - operational
                      - degraded
                      - down
                  services:
                    type: array
                    items:
                      type: object
                      required:
                        - id
                        - name
                        - group
                        - status
                        - latencyMs
                        - checkedAt
                        - detail
                        - impact
                        - uptime24h
                        - uptime7d
                        - history
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        group:
                          type: string
                          enum:
                            - HelloNear
                            - NEAR AI
                            - NEAR
                            - Partners
                        status:
                          type: string
                          enum:
                            - operational
                            - degraded
                            - down
                            - unknown
                        latencyMs:
                          type:
                            - number
                            - 'null'
                        checkedAt:
                          type:
                            - string
                            - 'null'
                          format: date-time
                        detail:
                          type:
                            - string
                            - 'null'
                        impact:
                          type: string
                        uptime24h:
                          type:
                            - number
                            - 'null'
                        uptime7d:
                          type:
                            - number
                            - 'null'
                        history:
                          type: array
                          items:
                            type: object
                            required:
                              - start
                              - status
                              - checks
                              - bad
                              - detail
                            properties:
                              start:
                                type: string
                                format: date-time
                              status:
                                type: string
                                enum:
                                  - operational
                                  - degraded
                                  - down
                                  - none
                              checks:
                                type: integer
                              bad:
                                type: integer
                              detail:
                                type:
                                  - string
                                  - 'null'
                  incidents:
                    type: array
                    items:
                      type: object
                      required:
                        - service
                        - name
                        - status
                        - start
                        - end
                        - minutes
                        - detail
                      properties:
                        service:
                          type: string
                        name:
                          type: string
                        status:
                          type: string
                          enum:
                            - down
                            - degraded
                        start:
                          type: string
                          format: date-time
                        end:
                          type:
                            - string
                            - 'null'
                          format: date-time
                        minutes:
                          type: integer
                        detail:
                          type:
                            - string
                            - 'null'
      security: []
components:
  securitySchemes:
    session:
      type: apiKey
      in: cookie
      name: hn_session

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.