action threatjammer_query_asn_prefixes_list_v1_asn_number_prefixes_get { label: "Get the list of IPv4 and IPv6 prefixes of the AS number given." description: "### What\nObtain the full list of IPv4 and IPv6 prefixes of the Autonomous System Number (ASN) passed as a parameter.\n\n### Parameters\nThe endpoint accepts only the following parameter in the path:\n- ``number``: (Mandatory) The ASN number to be queried.\n\n### Result\nThe result is a JSON object with the following structure:\n- ``self``: the URI of the API call\n- ``asn``: the URI to query the full details of the ASN.\n- ``prefixes_v4``: the list of IPv4 prefixes that belong to the ASN. Each element of the list 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.\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- ``prefixes_v6``: the list of IPv6 prefixes that belong to the ASN. Each element of the list is a JSON object with the following structure:\n - ``self``: the URI to individual IPv6 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: 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 AS was not found.\n- a `422 Unprocessable Entity` error if the AS number is malformed.\n\nIt will also return the API Global errors described in the API description." provider: threatjammer method: GET path: "/v1/asn/{number}/prefixes" encoding: json input: { type: "object" properties: { number: { type: "integer" } } required: ["number"] additionalProperties: false } output: { type: "object" required: ["prefixes_v4", "prefixes_v6", "self"] properties: { asn: { type: "string" } prefixes_v4: { type: "array" items: { type: "object" description: "AutonomousSystemPrefixResponse class to return the information to the user" required: ["object_type", "mantainer", "description"] 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" } } } } prefixes_v6: { type: "array" items: { type: "object" additionalProperties: true } } self: { type: "string" } } } }