Skip to content

Get Evaluation

Get Evaluation by ID. Requires an Evaluation ID.

GET /evaluation/<evaluation_id>

Example

from marqtune.client import Client

url = "https://marqtune.marqo.ai"
api_key = "{api_key}"
marqtune_client = Client(url=url, api_key=api_key)

marqtune_client.evaluation("evaluation_id").describe()

curl --location 'https://marqtune.marqo.ai/evaluation/{evaluation_id}' \
     --header 'x-api-key: {api_key}'

Response: 200 (OK)

Evaluation details returned. 

{
    "statusCode": 200,
    "body": {
        "evaluationId": "idInSystem",
        "status": "currentStatus", 
        "secondaryStatus": "secondaryStatus",
        "failureReason": "reasonForFailure", // Optional, present if status is failed
        "hyperparameters": "Evaluation task parameters - see the evaluation parameters guide for details." 
    }
}

Response: 400 (Invalid Request)

Request path or method is invalid. 

{
    "statusCode": 400,
    "body": {
      "message": "Invalid request method"
    }
}

Response: 400 (Invalid format)

Evaluation id format is not UUID 

{
  "statusCode": 400,
    "body": {
      "message": "Invalid evaluation id"
    }
}

Response: 401 (Unauthorised)

Unauthorised. Check your API key and try again. 

{
  "message": "Unauthorized."
}

Response: 404 (Not found)

Evaluation not found 

{
  "statusCode": 404,
    "body": {
      "message": "evaluation not found"
    }
}

Response: 500 (Internal server error)

Internal server error. Check your API key and try again. 

{
  "message": "Internal server error."
}

Notes on Optional Fields

  • failureReason: This field is included if the evaluation's status is failed. It provides the reason for the failure.