Get a specific version of a Registered Model (V2)
Get a specific version of a Registered Model with optional experiment run ID
curl --request GET \
--url https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version} \
--header 'X-Domino-Api-Key: <api-key>'import requests
url = "https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}"
headers = {"X-Domino-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Domino-Api-Key': '<api-key>'}};
fetch('https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Domino-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Domino-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}")
.header("X-Domino-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Domino-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"createdAt": "2022-03-12T02:13:44.467Z",
"modelName": "churn-prediction",
"modelVersion": 4,
"modelVersionDescription": "Customer churn model V1",
"ownerUsername": "martin_hito",
"project": {
"id": "62313ce67a0af0281c01a6a5",
"isGitBasedProject": true,
"name": "TO-DO",
"ownerUsername": "TO-DO"
},
"tags": {
"key": "value",
"key2": "anothervalue"
},
"updatedAt": "2022-03-12T02:13:44.467Z",
"versionUiDetails": {
"modelVersionDataSources": [
{
"dataSourceType": "<string>",
"id": "<string>",
"name": "<string>"
}
],
"modelVersionDatasets": [
{
"id": "<string>",
"name": "<string>",
"snapshotId": "<string>"
}
],
"experimentRunInfo": {
"metrics": [
{
"key": "<string>",
"timestamp": "2022-03-12T02:13:44.467Z",
"value": 123
}
],
"params": [
{
"key": "<string>",
"value": "<string>"
}
],
"runUrl": "<string>"
}
},
"buildStatus": "Succeeded",
"experimentRunId": "db79712b47084c27a463a188bf901943"
}{
"error": "<string>"
}{
"code": "UNAUTHORIZED",
"message": "Authentication is required to access this resource."
}{
"code": "FORBIDDEN",
"message": "You do not have permission to perform this action."
}{
"error": "<string>"
}{
"error": "<string>"
}Authorizations
Path Parameters
Registered model name
Version of the registered model
Response
Success
When the latest version of the model was created
"2022-03-12T02:13:44.467Z"
Name of the registered model
"churn-prediction"
The latest version of the model
4
Description of the model version
"Customer churn model V1"
username of the project owner
"martin_hito"
type that tracks properties of the project associated with a model
Show child attributes
Show child attributes
A map of key -> value
Show child attributes
Show child attributes
{ "key": "value", "key2": "anothervalue" }
When the latest version of the model was updated
"2022-03-12T02:13:44.467Z"
Show child attributes
Show child attributes
Current build status for GenAI models
Queued, Starting, Building, Succeeded, Failed, Killed "Succeeded"
The experiment run ID linked to the model version (only for MLflow models)
"db79712b47084c27a463a188bf901943"
Was this page helpful?
curl --request GET \
--url https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version} \
--header 'X-Domino-Api-Key: <api-key>'import requests
url = "https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}"
headers = {"X-Domino-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Domino-Api-Key': '<api-key>'}};
fetch('https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Domino-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Domino-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}")
.header("X-Domino-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://mycluster.domino.tech/api/registeredmodels/v2/{modelName}/versions/{version}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Domino-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"createdAt": "2022-03-12T02:13:44.467Z",
"modelName": "churn-prediction",
"modelVersion": 4,
"modelVersionDescription": "Customer churn model V1",
"ownerUsername": "martin_hito",
"project": {
"id": "62313ce67a0af0281c01a6a5",
"isGitBasedProject": true,
"name": "TO-DO",
"ownerUsername": "TO-DO"
},
"tags": {
"key": "value",
"key2": "anothervalue"
},
"updatedAt": "2022-03-12T02:13:44.467Z",
"versionUiDetails": {
"modelVersionDataSources": [
{
"dataSourceType": "<string>",
"id": "<string>",
"name": "<string>"
}
],
"modelVersionDatasets": [
{
"id": "<string>",
"name": "<string>",
"snapshotId": "<string>"
}
],
"experimentRunInfo": {
"metrics": [
{
"key": "<string>",
"timestamp": "2022-03-12T02:13:44.467Z",
"value": 123
}
],
"params": [
{
"key": "<string>",
"value": "<string>"
}
],
"runUrl": "<string>"
}
},
"buildStatus": "Succeeded",
"experimentRunId": "db79712b47084c27a463a188bf901943"
}{
"error": "<string>"
}{
"code": "UNAUTHORIZED",
"message": "Authentication is required to access this resource."
}{
"code": "FORBIDDEN",
"message": "You do not have permission to perform this action."
}{
"error": "<string>"
}{
"error": "<string>"
}