action unicourt_get_case_hearings {
  label: "Gets Hearings for a requested Case ID."
  description: "Gets Hearings for a requested Case ID."
  provider: unicourt
  method: GET
  path: "/case/{caseId}/hearings"
  encoding: json
  input: {
    type: "object"
    properties: {
      pageNumber: {
        type: "integer"
      }
      sortBy: {
        type: "string"
        enum: ["latest to oldest", "oldest to latest"]
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["hearingArray", "nextPageAPI", "object", "pageNumber", "totalCount", "totalPages"]
    properties: {
      hearingArray: {
        type: "array"
        items: {
          type: "object"
          required: ["object", "hearingDate", "hearingDescription", "hearingStructured", "location", "firstFetchDate", "lastFetchDate"]
          properties: {
            firstFetchDate: {
              type: "string"
              description: "When this hearing was first fetched from the source."
            }
            hearingDate: {
              type: "string"
              format: "date-time"
              description: "Hearing Date"
            }
            hearingDescription: {
              type: "string"
              description: "Source Hearing Description Text"
            }
            hearingStructured: {
              type: "object"
              required: ["rawOrderedDataArray", "extractedFields"]
              properties: {
                extractedFields: {
                  type: "object"
                  properties: {
                    key: {
                      type: "string"
                      description: "This can be an field that is extracted from rawOrderedDataArray on request of different users."
                    }
                  }
                }
                rawOrderedDataArray: {
                  type: "array"
                  items: {
                    type: "object"
                    required: ["ord", "lbl", "val", "childArray"]
                    properties: {
                      childArray: {
                        type: "array"
                        description: "Any docket text that belongs to the main docket text is added in the child."
                        items: {
                          type: "object"
                          required: ["ord", "lbl", "val", "childArray"]
                          properties: {
                            childArray: {
                              type: "object"
                              additionalProperties: true
                            }
                            lbl: {
                              type: "object"
                              additionalProperties: true
                            }
                            ord: {
                              type: "object"
                              additionalProperties: true
                            }
                            val: {
                              type: "object"
                              additionalProperties: true
                            }
                          }
                        }
                      }
                      lbl: {
                        type: "string"
                        description: "Label of the docket from the source."
                      }
                      ord: {
                        type: "integer"
                        description: "Structure order"
                      }
                      val: {
                        type: "string"
                        description: "List of available addresses."
                      }
                    }
                  }
                }
              }
            }
            lastFetchDate: {
              type: "string"
              description: "When this hearing was last fetched from the source."
            }
            location: {
              type: "string"
              description: "Location where the hearing will takeplace."
            }
            object: {
              type: "string"
              description: "Name of the object"
            }
          }
        }
      }
      nextPageAPI: {
        type: "string"
        description: "Link to next page of a particular entity in a Case."
      }
      object: {
        type: "string"
        description: "Name of the object"
      }
      pageNumber: {
        type: "integer"
        description: "Page number for which results where obtained."
      }
      totalCount: {
        type: "integer"
        description: "Total number of parties of the Case entity in a Case."
      }
      totalPages: {
        type: "integer"
        description: "Total number of pages to obtain all the objects of a party in the Case."
      }
    }
  }
}