---
title: "Health check interface"
method: GET
path: "/healthz"
tags: ["Health"]
---

# Health check interface

`GET /healthz`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/healthz`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/nvidia/apis/nvcf-nats-auth-callout-service-service-api/docs/healthz/get.ts> (a function with typed inputs; its response is checked against the schema)

liveness: fails only when the NATS connection is closed for good, so short NATS outages do not restart the service

## Response `200`

Health check success

- ModelsHealthResponse
  - `status` 'ok' | 'degraded' | 'down'

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `429`: Too many requests
- `500`: Internal server error
- `503`: NATS connection closed

## Changes

- **2026-10-14** `3afa2c7d1de2`: 1 info
  - added the non-success response with the status `503`

[Operation history](https://skmtc.dev/nvidia/apis/nvcf-nats-auth-callout-service-service-api/changes/healthz/get.md)

---

[API](https://skmtc.dev/nvidia/apis/nvcf-nats-auth-callout-service-service-api.md) - [All operations](https://skmtc.dev/nvidia/apis/nvcf-nats-auth-callout-service-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nvidia/apis/nvcf-nats-auth-callout-service-service-api/revisions/3afa2c7d1de2?raw)