Read Trial
Retrieves information about a specific optimization trial in globalMOO.
Endpoint
GET /trials/{trial_id}
Path Parameters
trial_id
integer
Yes
Unique identifier of the trial
Response Fields
id
integer
Unique identifier for the trial
project_id
integer
ID of the parent project
status
string
Current status (see Status Values below)
outputs
array[array[float]]
Array of output case arrays
output_count
integer
Number of outputs per case
created_at
string
Creation timestamp (ISO 8601)
updated_at
string
Last update timestamp (ISO 8601)
{
"id": 123,
"project_id": 456,
"status": "active",
"output_count": 3,
"outputs": [
[1.2, 3.4, 5.6],
[7.8, 9.0, 1.2],
[3.4, 5.6, 7.8]
],
"created_at": "2025-01-31T10:00:00.000Z",
"updated_at": "2025-01-31T10:00:00.000Z"
}Examples
from globalmoo import Client
client = Client(api_key="your-api-key")
trial = client.read_trial(trial_id=123)
print(f"Trial status: {trial.status}")
print(f"Output count: {trial.output_count}")
for outputs in trial.outputs:
print(f"Outputs: {outputs}")const { Client } = require('globalmoo');
const client = new Client('your-api-key');
const trial = await client.readTrial(123);
console.log(`Trial status: ${trial.status}`);
console.log(`Output count: ${trial.outputCount}`);
trial.outputs.forEach(outputs => {
console.log(`Outputs: ${outputs.join(', ')}`);
});$client = new Client("your-api-key");
$trial = $client->readTrial(123);
echo "Trial status: " . $trial->status . "\n";
echo "Output count: " . $trial->outputCount . "\n";
foreach ($trial->outputs as $outputs) {
echo "Outputs: " . implode(", ", $outputs) . "\n";
}Response Example
{
"id": 123,
"project_id": 456,
"status": "completed",
"output_count": 3,
"outputs": [
[1.234, 3.456, 5.678],
[7.890, 9.012, 1.234],
[3.456, 5.678, 7.890]
],
"created_at": "2025-01-31T10:00:00.000Z",
"updated_at": "2025-01-31T10:15:00.000Z"
}Error Responses
401
Unauthorized - Invalid API key
404
Trial not found
429
Too many requests - Rate limit exceeded
500
Internal server error
Status Values
Possible trial status values:
active- Trial is currently runningcompleted- Trial has finished successfullyfailed- Trial encountered an errorstopped- Trial was manually stopped
Validation Rules
Trial ID must be a positive integer
Trial must exist
output_count matches the number of values in each output array
All output values must be valid floating point numbers
Last updated