Search documentation
karat

+

K

User Documentation ↗
Version 2.0

Json Experiment Series

GET/api/v2/models/{modelRid}/experiments/{experimentRid}/series/{experimentSeriesName}/json
Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Retrieve raw time-series data for a single series in JSON format. Results are paginated with a default page size of 200 and a maximum of 1000.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:models-read.

Path parameters

modelRid
string

The Resource Identifier (RID) of a Model.

experimentRid
string

The Resource Identifier (RID) of an Experiment.

experimentSeriesName
string

The name of a series (metrics tracked over time).

Query parameters

pageSize
integeroptional

Maximum number of values to return per page. Default is 200, maximum is 1000.

offset
integeroptional

Number of values to skip from the beginning. Defaults to 0.

preview
booleanoptional

Enables the use of preview functionality.

Response body

Series
union

A series of values logged over time.

Hide child attributes

Hide child attributes

doubleV1
objectoptional

A series of double values.

Show child attributes

Show child attributes

Examples

Request

Copied!
1 2 3 curl \ \t-H "Authorization: Bearer $TOKEN" \ "https://$HOSTNAME/api/v2/models/ri.models.main.model.f351c142-0e4c-4b12-adc2-6e1539737ae9/experiments/ri.models.main.experiment.abc123/series/loss/json?preview=true"

Response

Copied!
1 2 3 4 5 6 7 8 9 10 { "type": "doubleV1", "series": [ { "value": 0.42, "timestamp": 1715212800000, "step": 1 } ] }

Error responses

Error Name
ExperimentSeriesNotFoundError CodeNOT_FOUND
Status Code404
DescriptionThe requested series was not found in the experiment.
ParametersmodelRid, experimentRid, seriesName
ModelExperimentNotFoundError CodeNOT_FOUND
Status Code404
DescriptionThe requested experiment was not found or the user lacks permission to access it.
ParametersmodelRid, experimentRid
JsonExperimentSeriesPermissionDeniedError CodePERMISSION_DENIED
Status Code403
DescriptionCould not json the ExperimentSeries.
ParametersexperimentSeriesName, experimentRid, modelRid