Health Status

The health status API is designed to return information about the overall health of the PrizmDoc Server.

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

This URL is intended to provide a quick, easily parseable indication as to the health of PrizmDoc Server. For more information about the current health, use GET /PCCIS/V1/Service/Current/Info.

Request

Request Headers

None.

Successful Response

Response Body

OK - for HTTP status code 200.
None/Empty - for HTTP status code 500.

Example

Request

GET /PCCIS/V1/Service/Current/Health

Response

HTTP/1.1 200 OK

GET /PCCIS/V1/Service/Current/Info

This API returns a JSON object indicating the health of PrizmDoc Server.

Request

Request Headers

None.

Successful Response

Response Body

If successful, this method returns the following properties:

serviceStatus (String) Status of PrizmDoc Server:
- "starting"
- "running"
- "unhealthy"
licenseStatus (String) Information about the PrizmDoc License:
- "not licensed"
- "licensed as '...'"
instances[] (Array of Objects) Objects describing the PrizmDoc Server instances that are currently running. Items contain:
- serviceStatus (String) Status of the PrizmDoc Server used for viewing.
- serviceInstallerVersion (String) Version of the installer used to install PrizmDoc Server.
- pccisVersion (String) Version of the PrizmDoc Server used for viewing.
- runtimeVersion (String) .NET runtime version supporting the PrizmDoc Server used for viewing.
- operatingSystem (String) Operating System of the server on which PrizmDoc Server is running.
- startTime (String) Last recorded time the PrizmDoc Server were started. Time is reported in UTC and is ISO-8601 format.
- instanceId (String) Host name of the server running PrizmDoc Server.
- childServices[] (Array of Objects) Objects describing the health status for each individual PrizmDoc Service. Items may contain:
  - name (String) Name of the child PrizmDoc Service.
  - status (String) Status of the child PrizmDoc Service:
    - "starting"
    - "running"
    - "unhealthy"

Example

Request

GET /PCCIS/V1/Service/Current/Info

Response

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

{
  "serviceStatus": "running",
  "licenseStatus": "licensed as 'PCC' ",
  "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"
        }
      ]
    }
  ]
}