action namsor_origin {
  label: "[USES 10 UNITS PER NAME] Infer the likely country of origin of a personal name. Assumes names as they are in the country of origin. For US, CA, AU, NZ and other melting-pots : use 'diaspora' instead."
  provider: namsor
  method: GET
  path: "/api2/json/origin/{firstName}/{lastName}"
  encoding: json
  input: {
    type: "object"
    properties: {
      firstName: {
        type: "string"
      }
      lastName: {
        type: "string"
      }
    }
    required: ["firstName", "lastName"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Represents the output of inferring the LIKELY country of Origin from a personal name."
    properties: {
      countriesOriginTop: {
        type: "array"
        description: "List countries of Origin (top 10)"
        items: {
          type: "string"
          description: "List countries of Origin (top 10)"
        }
      }
      countryOrigin: {
        type: "string"
        description: "Most likely country of Origin"
      }
      countryOriginAlt: {
        type: "string"
        description: "Second best alternative : country of Origin"
      }
      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 countryOrigin OR countryOriginAlt to have been guessed correctly. -1 = still calibrating. "
      }
      probabilityCalibrated: {
        type: "number"
        format: "double"
        description: "The calibrated probability for countryOrigin to have been guessed correctly. -1 = still calibrating. "
      }
      regionOrigin: {
        type: "string"
        description: "Most likely region of Origin (based on countryOrigin ISO2 code)"
      }
      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"
      }
      subRegionOrigin: {
        type: "string"
        description: "Most likely sub region of Origin (based on countryOrigin ISO2 code)"
      }
      topRegionOrigin: {
        type: "string"
        description: "Most likely top region of Origin (based on countryOrigin ISO2 code)"
      }
    }
  }
}