Skip to main content
GET
List monitors

Authorizations

Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Query Parameters

space_id
string

Filter search results to a particular space ID A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

space_name
string

Case-insensitive substring filter on the space name. Narrows results to resources in spaces whose name contains the given string. If omitted, no space name filtering is applied and all resources are returned.

Maximum string length: 255
name
string

Case-insensitive substring filter on the resource name. Returns only resources whose name contains the given string. For example, name=prod matches "production", "my-prod-dataset", etc. If omitted, no name filtering is applied and all resources are returned.

Maximum string length: 255
project_id
string

Filter results to resources associated with a specific project (base64 identifier). If omitted, results are not filtered by project.

A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

project_name
string

Exact-match filter on the name of the project the monitor's primary metric is computed over. Unlike name and space_name, this is an exact (case-sensitive) match, not a substring search. If omitted, no project name filtering is applied.

Maximum string length: 255
type
enum<string>

Filter by monitor type. Types are exact: DATA_QUALITY does not include TRACING monitors, and PERFORMANCE does not include CUSTOM_METRIC monitors. If omitted, monitors of all types are returned.

The kind of monitor. Determines which type-specific fields apply.

  • DATA_QUALITY - Monitors a data quality metric (e.g. percent empty, CARDINALITY).
  • PERFORMANCE - Monitors a model performance metric (e.g. ACCURACY, RMSE).
  • DRIFT - Monitors distributional drift of a feature/output.
  • CUSTOM_METRIC - Monitors a user-defined custom metric.
  • TRACING - Monitors a span/trace-derived metric (e.g. span attributes, evals).
Available options:
DATA_QUALITY,
PERFORMANCE,
DRIFT,
CUSTOM_METRIC,
TRACING
status
enum<string>

Filter by the monitor's current evaluation state (TRIGGERED, CLEARED, or NO_DATA). If omitted, monitors in every state are returned.

The monitor's current state from its most recent evaluation.

  • TRIGGERED - The metric breached the threshold.
  • CLEARED - The metric is within healthy bounds.
  • NO_DATA - No data was available to evaluate.
Available options:
TRIGGERED,
CLEARED,
NO_DATA
notifications_enabled
boolean

Filter by whether notifications fire on a triggered transition. true returns only monitors with notifications enabled; false returns only monitors with notifications disabled. If omitted, monitors are returned regardless of notification state.

dimension_category
enum<string>

Filter to monitors whose metric is computed over a dimension of this category. Values copied from a returned monitor's dimension.category work as filters. If omitted, no dimension category filtering is applied.

The category of dimension the metric is evaluated over.

Available options:
FEATURE_LABEL,
TAG,
MODEL_VERSION,
BATCH_ID,
SPAN_ATTRIBUTE,
LLM_EVAL,
USER_ANNOTATION,
ACTUALS,
ACTUALS_SCORE,
ACTUALS_CLASS,
PREDICTIONS,
PREDICTIONS_SCORE,
PREDICTIONS_CLASS
dimension_name
string

Exact-match filter on the name of the dimension the monitor's metric is computed over. Values copied from a returned monitor's dimension.name work as filters. If omitted, no dimension name filtering is applied.

Maximum string length: 255
data_quality_metric
enum<string>

Filter to monitors computing this data quality metric. Matches both DATA_QUALITY and TRACING monitors; combine with type to narrow to one of them. If omitted, no data quality metric filtering is applied.

The data quality metric computed over the selected dimension.

Available options:
COUNT,
PERCENT_EMPTY,
CARDINALITY,
NEW_VALUES,
MISSING_VALUES,
AVG,
SUM,
STANDARD_DEVIATION,
P50,
P95,
P99,
P99_9,
AVERAGE_STRING_LIST_LENGTH
performance_metric
enum<string>

Filter to PERFORMANCE monitors computing this performance metric. Does not match CUSTOM_METRIC monitors. If omitted, no performance metric filtering is applied.

The model performance metric.

Available options:
ACCURACY,
CALIBRATION,
F_1,
FALSE_NEGATIVE_DENSITY,
FALSE_NEGATIVE_RATE,
FALSE_POSITIVE_RATE,
PRECISION,
RECALL,
SENSITIVITY,
SPECIFICITY,
MICRO_AVERAGED_PRECISION,
MACRO_AVERAGED_PRECISION,
MULTI_CLASS_PRECISION,
MICRO_AVERAGED_RECALL,
MACRO_AVERAGED_RECALL,
MULTI_CLASS_RECALL,
ACTUALS_AVERAGE,
MAE,
MAPE,
MEAN_ERROR,
MSE,
PREDICTION_AVERAGE,
RMSE,
R_SQUARED,
SMAPE,
WAPE,
MASE,
AUC,
LOG_LOSS,
NDCG,
PR_AUC,
GROUP_AUC,
MRR,
RANKING_MAP,
RANKING_RECALL,
RANKING_PRECISION,
DISPARATE_IMPACT,
FALSE_POSITIVE_RATE_PARITY,
RECALL_PARITY
drift_metric
enum<string>

Filter to DRIFT monitors computing this drift metric. If omitted, no drift metric filtering is applied.

The statistical drift metric. PSI/KL/JS/KS apply to structured data; EUCLIDEAN_DISTANCE/COSINE_SIMILARITY apply to unstructured (embedding) data.

Available options:
PSI,
KL,
JS,
KS,
EUCLIDEAN_DISTANCE,
COSINE_SIMILARITY
custom_metric_id
string

Filter to CUSTOM_METRIC monitors evaluating this custom metric (base64 identifier). If omitted, no custom metric filtering is applied.

A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

limit
integer
default:50

Maximum items to return. Defaults to 50 if omitted; maximum is 100.

Required range: 1 <= x <= 100
cursor
string

Opaque pagination cursor returned from a previous response (pagination.next_cursor). Treat it as an unreadable token; do not attempt to parse or construct it.

Response

Returns a list of monitor objects

monitors
object[]
required

A list of monitors.

A monitor. The type field discriminates which variant (and therefore which type-specific fields) applies.

pagination
object
required

Pagination metadata for cursor-based navigation