Docs menu
API reference

GET /api/v1/health

Service health. Service status. Generated from the OpenAPI file.

Last updated

Overview

GET https://api.inlineshield.io/api/v1/health

Whether the API and its database are up. No authentication.

Authentication

No API key. This endpoint is public.

Request

No request body.

cURL
curl https://api.inlineshield.io/api/v1/health

Responses

200 OK

Operational.

FieldTypeRequiredDescription
statusstringyesValues: operational, degraded
databaseobjectyes
database.statusstringyesValues: connected, disconnected
operational
{
  "status": "operational",
  "database": {
    "status": "connected"
  }
}

503 Service Unavailable

Degraded.

FieldTypeRequiredDescription
statusstringyesValues: operational, degraded
databaseobjectyes
database.statusstringyesValues: connected, disconnected
degraded
{
  "status": "degraded",
  "database": {
    "status": "disconnected"
  }
}

Errors

Errors are JSON, { "error": "CODE", "message": "…" }. Branch on error, never on message.

HTTP statuserrorWhen
503–Degraded.

See all errors for every endpoint.

Headers and limits

This endpoint sends no rate-limit or quota headers. See Rate limits and quotas.