action namsor_subclassification {
  label: "[USES 10 UNITS PER NAME] Infer the likely origin of a name at a country subclassification level (state or regeion). Initially, this is only supported for India (ISO2 code 'IN')."
  provider: namsor
  method: GET
  path: "/api2/json/subclassification/{countryIso2}/{firstName}/{lastName}"
  encoding: json
  input: {
    type: "object"
    properties: {
      countryIso2: {
        type: "string"
      }
      firstName: {
        type: "string"
      }
      lastName: {
        type: "string"
      }
    }
    required: ["countryIso2", "firstName", "lastName"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Represents the geographic name origin at a country subclassification level (usually regional or state level)."
    properties: {
      countryIso2: {
        type: "string"
        description: "The input country ISO2 code"
      }
      firstName: {
        type: "string"
        description: "The first name (also known as given name)"
      }
      id: {
        type: "string"
      }
      lastName: {
        type: "string"
        description: "The last name (also known as family name, or surname)"
      }
      probabilityAltCalibrated: {
        type: "number"
        format: "double"
        description: "The calibrated probability for subclassification OR subclassificationAlt to have been guessed correctly. -1 = still calibrating. "
      }
      probabilityCalibrated: {
        type: "number"
        format: "double"
        description: "The calibrated probability for subclassification to have been guessed correctly. -1 = still calibrating. "
      }
      score: {
        type: "number"
        format: "double"
        description: "Compatibility to NamSor_v1 Origin score value. Higher score is better, but score is not normalized. Use calibratedProbability if available. "
      }
      script: {
        type: "string"
      }
      subClassification: {
        type: "string"
        description: "Most likely subclassification ISO_3166-2 code"
      }
      subClassificationAlt: {
        type: "string"
        description: "Second best alternative : subclassification ISO_3166-2 code"
      }
      subclassificationTop: {
        type: "array"
        description: "List subclassification ISO_3166-2 codes (top 10)"
        items: {
          type: "string"
          description: "List subclassification ISO_3166-2 codes (top 10)"
        }
      }
    }
  }
}