action namsor_country {
  label: "[USES 10 UNITS PER NAME] Infer the likely country of residence of a personal full name, or one surname. Assumes names as they are in the country of residence OR the country of origin."
  provider: namsor
  method: GET
  path: "/api2/json/country/{personalNameFull}"
  encoding: json
  input: {
    type: "object"
    properties: {
      personalNameFull: {
        type: "string"
      }
    }
    required: ["personalNameFull"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Classified geo names"
    properties: {
      countriesTop: {
        type: "array"
        description: "List countries (top 10)"
        items: {
          type: "string"
          description: "List countries (top 10)"
        }
      }
      country: {
        type: "string"
        description: "Most likely country "
      }
      countryAlt: {
        type: "string"
        description: "Second best alternative : country "
      }
      id: {
        type: "string"
      }
      name: {
        type: "string"
        description: "The input name."
      }
      probabilityAltCalibrated: {
        type: "number"
        format: "double"
        description: "The calibrated probability for country OR countryAlt to have been guessed correctly. -1 = still calibrating. "
      }
      probabilityCalibrated: {
        type: "number"
        format: "double"
        description: "The calibrated probability for country to have been guessed correctly. -1 = still calibrating. "
      }
      region: {
        type: "string"
        description: "Most likely region (based on country ISO2 code)"
      }
      score: {
        type: "number"
        format: "double"
        description: "Higher score is better, but score is not normalized. Use calibratedProbability if available. "
      }
      script: {
        type: "string"
      }
      subRegion: {
        type: "string"
        description: "Most likely sub region (based on country ISO2 code)"
      }
      topRegion: {
        type: "string"
        description: "Most likely top region (based on country ISO2 code)"
      }
    }
  }
}