action threatjammer_query_asn_prefix_information_v1_asn_prefix_post {
  label: "Get the IPv4 or IPv6 prefix of the CIDR given."
  description: "### What\nObtain the IPv4 or IPv6 prefix and the Autonomous System information of the CIDR passed in the body as a POST method. This endpoint works around the problem of passing '/' addresses in the URI.\n\n### Parameters\nThe endpoint accepts only the following parameter in the body as a JSON object:\n- ``prefix``: (Mandatory) The CIDR v4 or v6 to be queried.\n\n### Result\nThe result is a JSON object with the following structure:\n- ``self``: the URI to individual IPv4 prefix.\n- ``asn``: the URI to query the full details of the ASN.\n- ``object_type``: the type of the prefix. The allowed values are: IPv4 or IPv6.\n- ``maintainer``: the information about the maintainer of this prefix in the registry.\n- ``description``: the description of the prefix as registered in the registry.\n- ``registry_date``: the date of registration of the prefix in the registry. The format is YYYY-MM-DD.\n- ``registry_status``: the URI of the status of the prefix as stored in the registry.\n- ``score``: The risk score of the prefix. It ranges from 0 to 99.\n- ``risk``: The risk of the prefix. The allowed values are: LOW, MEDIUM, HIGH. It's a human readable representation of the score.\n\n### Errors\nThe endpoint will return the following errors:\n- a `404 Not Found` error if the prefix information was not found.\n- a `422 Unprocessable Entity` error if the CIDR is malformed.\n\nIt will also return the API Global errors described in the API description."
  provider: threatjammer
  method: POST
  path: "/v1/asn/prefix"
  encoding: json
  input: {
    type: "object"
    required: ["prefix"]
    properties: {
      prefix: {
        type: "string"
        format: "ipvanynetwork"
      }
    }
  }
  output: {
    type: "object"
    description: "AutonomousSystemPrefixResponse class to return the information to the user"
    required: ["description", "mantainer", "object_type"]
    properties: {
      asn: {
        type: "string"
      }
      description: {
        type: "string"
      }
      mantainer: {
        type: "string"
      }
      object_type: {
        type: "string"
      }
      registry_date: {
        type: "string"
      }
      registry_status: {
        type: "string"
      }
      risk: {
        type: "string"
        enum: ["UNKNOWN", "LOW", "MEDIUM", "HIGH"]
      }
      score: {
        type: "integer"
      }
      self: {
        type: "string"
      }
    }
  }
}