ResultListV1

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/centaur-labs/main/json-schema/centaur-labs-result-list-v1-schema.json",
  "title": "ResultListV1",
  "x-generated": "2026-10-14",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/centaur-labs-label-apis-openapi.yml#/components/schemas/ResultListV1",
  "type": "object",
  "properties": {
    "payload": {
      "type": "array",
      "description": "The list of labeling results.",
      "items": {
        "$ref": "#/$defs/ResultV1"
      }
    },
    "has_next": {
      "type": "boolean",
      "description": "Whether or not the list of labeling results has reached the end."
    },
    "last_sequence_id": {
      "type": "integer",
      "description": "If has_next is true, the last_sequence_id is the token that should accompany the next request to get the following page of results."
    },
    "limit": {
      "type": "integer",
      "description": "The maximum number of labeling results to retrieve per page."
    }
  },
  "$defs": {
    "ContentMetadata": {
      "type": "object",
      "properties": {
        "content_id": {
          "type": "integer",
          "description": "An identifier for the content."
        },
        "origin": {
          "type": "string",
          "description": "An identifier for the file origin of the content."
        },
        "created_at": {
          "type": "string",
          "description": "Timestamp that content was created."
        },
        "series": {
          "type": [
            "string",
            "null"
          ],
          "description": "An identifier for the series that the content belongs to."
        },
        "series_index": {
          "type": [
            "integer",
            "null"
          ],
          "description": "The index of the content within the series (if any) that it belongs to."
        },
        "dicom_study_uid": {
          "type": [
            "string",
            "null"
          ],
          "description": "The DICOM study UID of the content."
        },
        "dicom_series_uid": {
          "type": [
            "string",
            "null"
          ],
          "description": "The DICOM series UID of the content."
        },
        "dicom_instance_uid": {
          "type": [
            "string",
            "null"
          ],
          "description": "The DICOM instance UID of the content."
        }
      }
    },
    "ResultV1": {
      "type": "object",
      "properties": {
        "task_id": {
          "type": "integer",
          "description": "The task ID."
        },
        "task_name": {
          "type": "string",
          "description": "The task name."
        },
        "project_id": {
          "type": "integer",
          "description": "The project ID."
        },
        "project_name": {
          "type": "string",
          "description": "The project name."
        },
        "case_id": {
          "type": "integer",
          "description": "The case ID."
        },
        "task_type": {
          "type": "string",
          "description": "The labeling task (e.g. choice, box, circle, etc.)"
        },
        "patch": {
          "type": [
            "string",
            "null"
          ],
          "description": "An identifier for the patch within the image to be labeled."
        },
        "labeling_state": {
          "type": "string",
          "description": "The labeling state of the case (e.g. Labeled, Gold Standard, etc.)"
        },
        "qualified_reads": {
          "type": "integer",
          "description": "The number of qualified reads collected for the case."
        },
        "content_metadata": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ContentMetadata"
          }
        },
        "portal_url": {
          "type": "string",
          "description": "URL to access view case in the Centaur portal."
        },
        "internal_notes": {
          "type": [
            "string",
            "null"
          ],
          "description": "Internal notes for the case."
        },
        "explanation": {
          "type": [
            "string",
            "null"
          ],
          "description": "Explanation for the case."
        },
        "comments": {
          "type": "array",
          "description": "Comments submitted by users on the case.",
          "items": {
            "type": "string"
          }
        },
        "flags": {
          "type": "array",
          "description": "Messages submitted by users who flagged the case.",
          "items": {
            "type": "string"
          }
        },
        "results": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "content_id": {
                "type": "integer",
                "description": "An identifier for the content to which these results apply. If the case involves multiple content IDs, the lowest content ID is given."
              },
              "correct_label": {
                "type": [
                  "array",
                  "null"
                ],
                "description": "The correct label for the case.  If the case is a segmentation task, then the contained strings will be in WKT format.",
                "items": {
                  "type": "string"
                }
              },
              "majority_label": {
                "type": [
                  "array",
                  "null"
                ],
                "description": "The majority label for the case based on user opinions.  If the case is a segmentation task, then the contained strings will be in WKT format.",
                "items": {
                  "type": "string"
                }
              },
              "agreement": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "The agreement between user opinions on the case."
              },
              "difficulty": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "The difficulty of the case."
              },
              "read_stats": {
                "type": "object",
                "description": "Read statistics for user opinions on the case.  Only included for classification tasks.",
                "properties": {
                  "counts": {
                    "type": "object",
                    "description": "Vote count breakdown by label category for user opinions on the case."
                  },
                  "weights": {
                    "type": "object",
                    "description": "Confidence level by label category for user opinions on the case."
                  }
                }
              },
              "top_reads": {
                "type": "array",
                "description": "The list of top user opinions used to create the majority label for the case.  Only included for segmentation tasks.",
                "items": {
                  "type": "object",
                  "properties": {
                    "read_id": {
                      "type": "integer",
                      "description": "An identifier for the user opinion."
                    },
                    "user_id": {
                      "type": "integer",
                      "description": "The ID of the user who submitted the opinion."
                    },
                    "accuracy": {
                      "type": "number",
                      "description": "The confidence level of the user opinion."
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}