action unicourt_get_case_attorneys {
  label: "Gets Attorneys for a requested Case ID."
  description: "Retrieve the attorneys in the case with the specified caseId value."
  provider: unicourt
  method: GET
  path: "/case/{caseId}/attorneys"
  encoding: json
  input: {
    type: "object"
    properties: {
      isVisible: {
        type: "boolean"
      }
      pageNumber: {
        type: "integer"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["attorneyArray", "nextPageAPI", "object", "pageNumber", "totalCount", "totalPages"]
    properties: {
      attorneyArray: {
        type: "array"
        items: {
          type: "object"
          required: ["object", "attorneyId", "name", "namePrefix", "firstName", "middleName", "lastName", "nameSuffix", "contact", "attorneyLawFirmArray", "barNumber", "attorneyType", "sourceAttorneyType", "isVisible", "firstFetchDate", "lastFetchDate", "partyAttorneyAssociations", "possibleNormAttorneyArray", "possibleNormLawFirmArray", "partyRoleGroupIdArray", "partyRoleIdArray"]
          properties: {
            attorneyId: {
              type: "string"
              description: "ID for the attorney in this case. This ID is unique within a case and NOT across cases. If the same attorney were to appear in another case this ID would be different."
            }
            attorneyLawFirmArray: {
              type: "array"
              items: {
                type: "object"
                description: "Name of the attorney's law firm as provided by Court. This can be null as some Courts do not provide this as a separate field."
                required: ["object", "attorneyLawFirmId", "name", "isVisible", "firstFetchDate", "lastFetchDate"]
                properties: {
                  attorneyLawFirmId: {
                    type: "string"
                    description: "ID for the law firm of an attorney in this case. This ID is unique within a case and NOT across cases. If the same attorney were to appear in another case this ID would be different."
                  }
                  firstFetchDate: {
                    type: "string"
                    description: "Is the date when the document was first fetched from the court site."
                  }
                  isVisible: {
                    type: "boolean"
                    description: "Signifies if the attorney as this attorney type is currently isVisible or not for the case."
                  }
                  lastFetchDate: {
                    type: "string"
                    description: "Is the date when the document was last fetched from the court site."
                  }
                  name: {
                    type: "string"
                    description: "Name of the law firm as provided by Court."
                  }
                  object: {
                    type: "string"
                    description: "Name of the object"
                  }
                }
              }
            }
            attorneyType: {
              type: "object"
              required: ["object", "attorneyTypeId", "name", "createdDate"]
              properties: {
                attorneyTypeId: {
                  type: "string"
                }
                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."
                }
                name: {
                  type: "string"
                }
                object: {
                  type: "string"
                }
              }
            }
            barNumber: {
              type: "string"
              description: "The bar enrollment number of an attorney."
            }
            contact: {
              type: "object"
              description: "Contact object data schema."
              required: ["addressArray", "phoneNumberArray", "emailArray", "object"]
              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 attorney first fetched from the court site."
            }
            firstName: {
              type: "string"
              description: "First name of the attorney. This is normalized by UniCourt."
            }
            isVisible: {
              type: "boolean"
              description: "Signifies if the attorney as this attorney type is currently isVisible or not for the case."
            }
            lastFetchDate: {
              type: "string"
              format: "date-time"
              description: "When was the attorney last fetched from the court site."
            }
            lastName: {
              type: "string"
              description: "Last name of the attorney. This is normalized by UniCourt."
            }
            middleName: {
              type: "string"
              description: "Middle name of the attorney. This is normalized by UniCourt."
            }
            name: {
              type: "string"
              description: "Name of the attorney as provided by Court."
            }
            namePrefix: {
              type: "string"
            }
            nameSuffix: {
              type: "string"
            }
            object: {
              type: "string"
              description: "Name of the object"
            }
            partyAttorneyAssociations: {
              type: "object"
              required: ["object", "pageNumber", "partyAttorneyAssociationArray", "totalPages", "nextPageAPI", "totalCount"]
              properties: {
                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."
                }
                partyAttorneyAssociationArray: {
                  type: "array"
                  items: {
                    type: "object"
                    required: ["object", "partyAttorneyAssociationId", "attorneyId", "partyId", "isVisible"]
                    properties: {
                      attorneyId: {
                        type: "string"
                        description: "ID for the attorney in this case. This ID is unique within a case and NOT across cases. If the same attorney were to appear in another case this ID would be different."
                      }
                      isVisible: {
                        type: "boolean"
                        description: "Signifies if this party attorney relationship is currently isVisible or not for the case."
                      }
                      object: {
                        type: "string"
                        description: "Name of the object"
                      }
                      partyAttorneyAssociationId: {
                        type: "string"
                        description: "ID of the association"
                      }
                      partyId: {
                        type: "string"
                        description: "ID for the party in this case. This ID is unique within a case and NOT across cases. If the same attorney were to appear in another case this ID would be different."
                      }
                    }
                  }
                }
                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."
                }
              }
            }
            partyRoleGroupIdArray: {
              type: "array"
              description: "Party Role Group Id for a Attorney."
              items: {
                type: "string"
              }
            }
            partyRoleIdArray: {
              type: "array"
              description: "Party Role Id for a Attorney."
              items: {
                type: "string"
              }
            }
            possibleNormAttorneyArray: {
              type: "array"
              items: {
                type: "object"
                required: ["object", "normAttorneyId", "normAttorneyName", "bestMatch", "confidenceScore", "scoreConstituents", "normAttorneyAPI", "associatedNormJudgesAPI", "associatedNormLawFirmsAPI", "associatedNormPartiesAPI", "caseCountAnalyticsByNormAttorneyAPI", "caseCountAnalyticsByOpposingNormAttorneyAPI"]
                properties: {
                  associatedNormJudgesAPI: {
                    type: "string"
                    format: "uri"
                  }
                  associatedNormLawFirmsAPI: {
                    type: "string"
                    format: "uri"
                  }
                  associatedNormPartiesAPI: {
                    type: "string"
                    format: "uri"
                  }
                  bestMatch: {
                    type: "boolean"
                  }
                  caseCountAnalyticsByNormAttorneyAPI: {
                    type: "string"
                    format: "uri"
                  }
                  caseCountAnalyticsByOpposingNormAttorneyAPI: {
                    type: "string"
                    format: "uri"
                  }
                  confidenceScore: {
                    type: "number"
                    format: "float"
                  }
                  normAttorneyAPI: {
                    type: "string"
                    format: "uri"
                  }
                  normAttorneyId: {
                    type: "string"
                  }
                  normAttorneyName: {
                    type: "string"
                  }
                  object: {
                    type: "string"
                    description: "Name of the object"
                  }
                  scoreConstituents: {
                    type: "object"
                    required: ["nameSimilarityScore", "otherPotentialNormAttorneys", "barId", "address", "email", "phone", "lawFirm"]
                    properties: {
                      address: {
                        type: "string"
                        enum: ["Matched", "Mismatched", "Not_Provided_By_Data_Source"]
                      }
                      barId: {
                        type: "string"
                        enum: ["Matched", "Mismatched", "Not_Provided_By_Data_Source"]
                      }
                      email: {
                        type: "string"
                        enum: ["Matched", "Mismatched", "Not_Provided_By_Data_Source"]
                      }
                      lawFirm: {
                        type: "string"
                        enum: ["Matched", "Mismatched", "Not_Provided_By_Data_Source"]
                      }
                      nameSimilarityScore: {
                        type: "number"
                        format: "float"
                      }
                      otherPotentialNormAttorneys: {
                        type: "integer"
                      }
                      phone: {
                        type: "string"
                        enum: ["Matched", "Mismatched", "Not_Provided_By_Data_Source"]
                      }
                    }
                  }
                }
              }
            }
            possibleNormLawFirmArray: {
              type: "array"
              description: "Possible Norm Lawfirm array for a Attorney."
              items: {
                type: "object"
                required: ["object", "normLawFirmId", "normLawFirmName", "bestMatch", "sourceDetails", "confidenceScore", "scoreConstituents", "normLawFirmAPI", "associatedNormAttorneyAPI", "associatedNormJudgeAPI", "associatedNormPartiesAPI", "caseCountAnalyticsByNormLawFirmAPI", "caseCountAnalyticsByOpposingNormLawFirmAPI"]
                properties: {
                  associatedNormAttorneyAPI: {
                    type: "string"
                    format: "uri"
                  }
                  associatedNormJudgeAPI: {
                    type: "string"
                    format: "uri"
                  }
                  associatedNormPartiesAPI: {
                    type: "string"
                    format: "uri"
                  }
                  bestMatch: {
                    type: "boolean"
                  }
                  caseCountAnalyticsByNormLawFirmAPI: {
                    type: "string"
                    format: "uri"
                  }
                  caseCountAnalyticsByOpposingNormLawFirmAPI: {
                    type: "string"
                    format: "uri"
                  }
                  confidenceScore: {
                    type: "number"
                    format: "float"
                  }
                  normLawFirmAPI: {
                    type: "string"
                    format: "uri"
                  }
                  normLawFirmId: {
                    type: "string"
                  }
                  normLawFirmName: {
                    type: "string"
                  }
                  object: {
                    type: "string"
                    description: "Name of the object"
                  }
                  scoreConstituents: {
                    type: "object"
                    required: ["nameSimilarityScore", "otherPotentialNormLawFirms", "secretaryOfStateId", "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"
                      }
                      otherPotentialNormLawFirms: {
                        type: "integer"
                      }
                      phone: {
                        type: "string"
                        enum: ["Matched", "Mismatched", "Not_Provided_By_Data_Source"]
                      }
                      secretaryOfStateId: {
                        type: "string"
                        enum: ["Matched", "Mismatched", "Not_Provided_By_Data_Source"]
                      }
                    }
                  }
                  sourceDetails: {
                    type: "object"
                    required: ["source", "linkedNormAttorneyIdArray"]
                    properties: {
                      linkedNormAttorneyIdArray: {
                        type: "array"
                        items: {
                          type: "string"
                        }
                      }
                      source: {
                        type: "string"
                        enum: ["Case_Attorney_Linked_In_Other_Cases", "Case_Attorney_Field_Contains_Law_Firm"]
                      }
                    }
                  }
                }
              }
            }
            sourceAttorneyType: {
              type: "string"
              description: "Attorney Type as provided by Court."
            }
          }
        }
      }
      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."
      }
    }
  }
}