PrizmDoc Viewer v13.11 Release - Updated
Health Status
API Reference > PrizmDoc Server REST API > Health Status

Introduction

For PrizmDoc Server Self-Hosted customers, the health status API is designed to return information about the overall health of a specific PrizmDoc Server instance.

Available URLs

URL Description
GET /PCCIS/V1/Service/Current/Health Returns the following HTTP status codes to reflect the overall health of the PrizmDoc Server: 200 - if the system is running and no health issues exist. 500 - if the system (some or all of PrizmDoc Server) is unhealthy.
GET /PCCIS/V1/Service/Current/Info This API returns a JSON object indicating the health of PrizmDoc Server.

GET /PCCIS/V1/Service/Current/Health

Determines whether or not a specific PrizmDoc Server instance is healthy.

Response

You can use the HTTP status code to determine the health of the instance:

HTTP Status Code Status
200 Healthy
500 Unhealthy

You can also determine health by looking at the response body. When healthy, the response body will be plaintext with a value of OK. When unhealthy, the response will have no body.

Example

Request

GET http://prizmdoc_server_base_url/PCCIS/V1/Service/Current/Health

Response

HTTP/1.1 200 OK

OK

GET /PCCIS/V1/Service/Current/Info

Gets metadata about the current status of a specific PrizmDoc Server instance.

Successful Response

Response Body

JSON with the following:

Example

Request

GET http://prizmdoc_server_base_url/PCCIS/V1/Service/Current/Info

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "serviceStatus": "running",
  "licenseStatus": "licensed as 'Acme Inc.'",
  "instances": [
    {
      "serviceStatus": "running",
      "serviceInstallerVersion": "XX.X.XX.XXX",
      "pccisVersion": "XX.X.XX.XXXX",
      "runtimeVersion": "4.0.30319.34014",
      "operatingSystem": "Microsoft Windows NT 6.3.9600.0",
      "startTime": "1971-01-01T00:00:00.0Z",
      "instanceId": "myhostname",
      "childServices": [
        {
          "name": "PCC Error Reporting Service",
          "serviceStatus": "running"
        },
        {
          "name": "PCC Imaging Conversion Service",
          "serviceStatus": "running",
          "version": "X.X.XXXX.XXXX"
        },
        {
          "name": "PCC PDF Processing Service",
          "serviceStatus": "running"
        },
        {
          "name": "PCC Raster Conversion Service",
          "serviceStatus": "running",
          "version": "X.X.XXXX.XXXX"
        },
        {
          "name": "PCC Vector Conversion Service",
          "serviceStatus": "running",
          "version": "X.X.XXXX.XXXX"
        },
        {
          "name": "PCC Html Conversion Service",
          "serviceStatus": "running",
          "version": "X.X.XXXX.XXXX"
        },
        {
          "name": "PCC Work File Service",
          "serviceStatus": "running",
          "version": "X.X.X"
        },
        {
          "name": "PCC Office Conversion Service",
          "serviceStatus": "running",
          "version": "X.XX.XXXX.XXXX"
        },
        {
          "name": "PCC Format Detection Service",
          "serviceStatus": "running"
        },
        {
          "name": "PCC AutoRedaction Service",
          "serviceStatus": "running"
        },
        {
          "name": "PCC Redaction Service",
          "serviceStatus": "running",
          "version": "X.X.X"
        },
        {
          "name": "PCC Email Processing Service",
          "serviceStatus": "running"
        },
        {
          "name": "PCC Email Conversion Service",
          "serviceStatus": "running",
          "version": "X.X.XXXX.XXXX"
        },
        {
          "name": "PCC Content Conversion Service",
          "serviceStatus": "running"
        },
        {
          "name": "configuration-service",
          "serviceStatus": "running"
        },
        {
          "name": "licensing-service",
          "serviceStatus": "running"
        },
        {
          "name": "health-service",
          "serviceStatus": "running"
        }
      ]
    }
  ]
}