action unicourt_get_judge_by_id {
  label: "Gets details for a requested Judge ID."
  description: "Retrieve the judge with the specified judgeId value."
  provider: unicourt
  method: GET
  path: "/judge/{judgeId}"
  encoding: json
  output: {
    type: "object"
    required: ["contact", "firstFetchDate", "firstName", "isVisible", "judgeId", "judgeType", "lastFetchDate", "lastName", "middleName", "name", "namePrefix", "nameSuffix", "object", "possibleNormJudgeArray", "sourceJudgeType"]
    properties: {
      contact: {
        type: "object"
        description: "Contact object data schema."
        required: ["addressArray", "emailArray", "object", "phoneNumberArray"]
        properties: {
          addressArray: {
            type: "array"
            description: "List of available addresses."
            items: {
              type: "object"
              description: "Address object Data Schema"
              required: ["object", "streetAddress1", "streetAddress2", "city", "stateName", "stateCode", "countryName", "countryCode", "zip", "zip4", "isVisible", "firstFetchDate", "lastFetchDate", "latitude", "longitude"]
              properties: {
                city: {
                  type: "string"
                  description: "City"
                }
                countryCode: {
                  type: "string"
                  description: "ISO 3166-1 alpha-3 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Officially_assigned_code_elements). Code of the country if country name is present."
                }
                countryName: {
                  type: "string"
                  description: "Country Name if present else default value."
                }
                firstFetchDate: {
                  type: "string"
                  format: "date-time"
                  description: "Date at which this record is created in UniCourt."
                }
                isVisible: {
                  type: "boolean"
                  description: "Boolean indicating if the address is visible or not."
                }
                lastFetchDate: {
                  type: "string"
                  format: "date-time"
                  description: "Date at which this record was updated in UniCourt."
                }
                latitude: {
                  type: "number"
                  description: "Coordinates at geographic coordinate system."
                }
                longitude: {
                  type: "number"
                  description: "Coordinates at geographic coordinate system."
                }
                object: {
                  type: "string"
                }
                stateCode: {
                  type: "string"
                  description: "State Code if the state is a US state else contains null."
                }
                stateName: {
                  type: "string"
                  description: "State Name if present else default value."
                }
                streetAddress1: {
                  type: "string"
                  description: "1st part of the street address."
                }
                streetAddress2: {
                  type: "string"
                  description: "2nd part of the street address."
                }
                zip: {
                  type: "string"
                  description: "Zip code of the address."
                }
                zip4: {
                  type: "string"
                  description: "4 digit extension of the zip code if the address is a US address."
                }
              }
            }
          }
          emailArray: {
            type: "array"
            description: "List of available emails."
            items: {
              type: "object"
              description: "Email object data schema."
              required: ["emailId", "isVisible", "firstFetchDate", "lastFetchDate", "object"]
              properties: {
                emailId: {
                  type: "string"
                  description: "email id"
                }
                firstFetchDate: {
                  type: "string"
                  format: "date-time"
                  description: "Date at which this record is created in UniCourt."
                }
                isVisible: {
                  type: "boolean"
                  description: "Boolean indicating if the email is visible or not."
                }
                lastFetchDate: {
                  type: "string"
                  format: "date-time"
                  description: "Date at which this record was updated in UniCourt."
                }
                object: {
                  type: "string"
                }
              }
            }
          }
          object: {
            type: "string"
          }
          phoneNumberArray: {
            type: "array"
            description: "List of available phone numbers."
            items: {
              type: "object"
              description: "Phone object data schema."
              required: ["phoneNumber", "phoneType", "isVisible", "firstFetchDate", "lastFetchDate", "object"]
              properties: {
                firstFetchDate: {
                  type: "string"
                  format: "date-time"
                  description: "Date at which this record is created in UniCourt."
                }
                isVisible: {
                  type: "boolean"
                  description: "Boolean indicating if the phone is visible or not."
                }
                lastFetchDate: {
                  type: "string"
                  format: "date-time"
                  description: "Date at which this record was updated in UniCourt."
                }
                object: {
                  type: "string"
                }
                phoneNumber: {
                  type: "string"
                  description: "Phone Number"
                }
                phoneType: {
                  type: "string"
                  description: "Resolved phone type (ideally from master data)."
                  enum: ["DEFAULT", "OFFICE", "FAX", "PHONE"]
                }
              }
            }
          }
        }
      }
      firstFetchDate: {
        type: "string"
        format: "date-time"
        description: "When was the judge first fetched from the court site."
      }
      firstName: {
        type: "string"
        description: "First name of the judge. This is normalized by UniCourt."
      }
      isVisible: {
        type: "boolean"
        description: "Signifies if the judge as this judge type is currently isVisible or not for the case."
      }
      judgeId: {
        type: "string"
        description: "ID for the judge in this case. This ID is unique within a case and NOT across cases. If the same Judge were to appear in another case this ID would be different."
      }
      judgeType: {
        type: "object"
        required: ["createdDate", "judgeTypeId", "name", "object"]
        properties: {
          createdDate: {
            type: "string"
            format: "date-time"
            description: "The date and time when it was first created. This date and time is in UTC. Formatted as YYYY-MM-DD HH:MM:SS."
          }
          judgeTypeId: {
            type: "string"
          }
          name: {
            type: "string"
          }
          object: {
            type: "string"
          }
        }
      }
      lastFetchDate: {
        type: "string"
        format: "date-time"
        description: "When was the judge last fetched from the court site."
      }
      lastName: {
        type: "string"
        description: "Last name of the judge. This is normalized by UniCourt."
      }
      middleName: {
        type: "string"
        description: "Middle name of the judge. This is normalized by UniCourt."
      }
      name: {
        type: "string"
        description: "Name of the judge as provided by Court."
      }
      namePrefix: {
        type: "string"
      }
      nameSuffix: {
        type: "string"
      }
      object: {
        type: "string"
        description: "Name of the object"
      }
      possibleNormJudgeArray: {
        type: "array"
        items: {
          type: "object"
          required: ["object", "normJudgeId", "normJudgeName", "bestMatch", "confidenceScore", "scoreConstituents", "normJudgeAPI", "associatedNormAttorneysAPI", "associatedNormLawFirmsAPI", "associatedNormPartiesAPI", "caseCountAnalyticsByNormJudgeAPI"]
          properties: {
            associatedNormAttorneysAPI: {
              type: "string"
              format: "uri"
            }
            associatedNormLawFirmsAPI: {
              type: "string"
              format: "uri"
            }
            associatedNormPartiesAPI: {
              type: "string"
              format: "uri"
            }
            bestMatch: {
              type: "boolean"
            }
            caseCountAnalyticsByNormJudgeAPI: {
              type: "string"
              format: "uri"
            }
            confidenceScore: {
              type: "number"
              format: "float"
            }
            normJudgeAPI: {
              type: "string"
              format: "uri"
              description: "Link to Details For the Judge."
            }
            normJudgeId: {
              type: "string"
            }
            normJudgeName: {
              type: "string"
            }
            object: {
              type: "string"
              description: "Name of the object"
            }
            scoreConstituents: {
              type: "object"
              required: ["nameSimilarityScore", "otherPotentialNormJudges", "address", "email", "phone"]
              properties: {
                address: {
                  type: "string"
                  enum: ["Matched", "Mismatched", "Not_Provided_By_Data_Source"]
                }
                email: {
                  type: "string"
                  enum: ["Matched", "Mismatched", "Not_Provided_By_Data_Source"]
                }
                nameSimilarityScore: {
                  type: "number"
                  format: "float"
                }
                otherPotentialNormJudges: {
                  type: "integer"
                }
                phone: {
                  type: "string"
                  enum: ["Matched", "Mismatched", "Not_Provided_By_Data_Source"]
                }
              }
            }
          }
        }
      }
      sourceJudgeType: {
        type: "string"
      }
    }
  }
}