---
title: "Fetch Status Checks associated with a given service"
method: GET
path: "/services/{serviceId}/status-checks"
tags: ["services"]
---

# Fetch Status Checks associated with a given service

`GET /services/{serviceId}/status-checks`

Requires the privilege [`SERVICES_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `serviceId` string, required

## Query parameters

- `teamId` string, required

## Response `default`

default response

- ServiceStatusCheckResponse
  - `serviceStatusChecks` ServiceStatusCheck[]
    - `id` string
    - `integration` TeamExternalIntegrationReference — Represents the configuration for referencing an external integration
      - `type` 'JIRA' | 'DATADOG' | 'DATADOG_EU' | 'DATADOG_US3' | 'DATADOG_US5' | 'DATADOG_US1_FED' | 'PAGERDUTY' | 'NEWRELIC' | 'GRAFANA' | 'DYNATRACE' | 'APPDYNAMICS' | 'PROMETHEUS' | 'CUSTOM' | 'K6' | 'LOAD_GENERATOR_CUSTOM' | 'AWS' | 'AZURE' | 'GCP' — The type of the external integration for the health check to be created/updated
      - `observabilityToolType` 'DATADOG' | 'PAGERDUTY' | 'NEWRELIC' | 'GRAFANA' | 'DYNATRACE' | 'APPDYNAMICS' | 'PROMETHEUS' | 'CUSTOM' | 'AWS' | 'AZURE' — The observability tool type of the external integration for the health check to be created/updated
      - `domain` string — The domain of the observability tool type of the external integration for the health check to be created/updated
      - `name` string, required — The name of the external integration for the health check to be created/updated
    - `name` string
    - `evaluationConfiguration` EvaluationConfiguration — The configuration for evaluating the success/failure of a status check
      - `okLatencyMaxMs` integer — The maximum latency in milliseconds for a successful status check
      - `okStatusCodes` string[], required — The list of successful response status codes for a successful status check
      - `responseBodyEvaluation` ResponseBodyEvaluation — The configuration for evaluating the success of a response body
        - `op` 'AND' | 'OR', required — The operation to logically combine predicates into a success or failure
        - `predicates` PredicateObject[], required — The list of predicates to evaluate against the status check response body
          - `comparator` HasCompareFunctionObject
          - `type` 'String' | 'Number' | 'Boolean', required — The type of primitive this predicate operates on
          - `jpQuery` string, required — The json path query to run to read from the response body
          - `rValue` object, required — The right hand value of the predicate
    - `isContinuous` boolean
    - `isAutogenerated` boolean
    - `description` string
    - `autoGeneratedFromIdentifier` string
    - `category` 'ERRORS' | 'LATENCY' | 'REQUESTS' | 'UNKNOWN'
    - `categoryAudit` CategoryAudit
      - `categorySetOn` string, date-time
      - `categorySetBy` string
  - `autoGremlinAwsStatusChecks` GremlinAwsStatusCheckMetadata[]
    - `identifier` string
    - `name` string
    - `description` string
    - `definition` AwsHealthCheckDefinition
      - `resultId` string
      - `evaluationQuery` string
      - `evaluationComparator` 'EQU' | 'EQUALS' | 'NEQ' | 'NOT_EQUALS' | 'LES' | 'LESS_THAN' | 'LEQ' | 'LESS_THAN_OR_EQUAL_TO' | 'GRT' | 'GREATER_THAN' | 'GEQ' | 'GREATER_THAN_OR_EQUAL_TO'
      - `metricDataQueries` MetricDataQuery[]
      - `thresholdStrategy` ThresholdStrategy
        - `type` string, required
    - `enabled` boolean
    - `category` 'ERRORS' | 'LATENCY' | 'REQUESTS' | 'UNKNOWN'
  - `loadBalancerStates` LoadBalancerState[]
    - `accountId` string
    - `name` string
    - `arn` string
    - `state` 'ACTIVE' | 'IDLE' | 'DISAPPEARED'

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: SERVICES_READ

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/versions/70fe938a0b35/schema)