{"type":"api","title":"Get BGP Route Information for IP","meta":{"id":"/apps/pubhub/media/legacy-umbrella-api/bf58de618cbb72dda8f39b0414ce94c0a15cd467/f963d12c-70c5-3340-bb7c-d5cff60c643a","info":{"title":"Investigate API","description":"Umbrella Investigate API","version":"1.1.4","contact":{"name":"Cloud Security Developer Community"}},"security":[{"bearerAuth":[]}],"tags":[{"name":"Domain Status and Categorization"},{"name":"Domain Volume"},{"name":"Co-occurrences for a Domain"},{"name":"Passive DNS"},{"name":"Tagging Timeline"},{"name":"Subdomains for a Domain"},{"name":"Related Domains for a Domain"},{"name":"Security Information for a Domain"},{"name":"AS Information for a Domain"},{"name":"WHOIS Information for a Domain"},{"name":"Umbrella Popularity List-Top Million Domains"},{"name":"Search Domain"},{"name":"Cisco Secure Malware Analytics Integration"}],"x-parser-conf":{"overview":{"markdownPath":"investigate/investigate-explorer-overview.md"}},"openapi":"3.0.0","servers":[{"url":"https://investigate.api.umbrella.com"}],"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"spec":{"summary":"Get BGP Route Information for IP","operationId":"getBgpRoutesIp","tags":["AS Information for a Domain"],"description":"This endpoint provides data about ASN and IP relationships,\nshowing how IP addresses are related to each other and to the regional registries.\nYou can find out more about the IP space associated with an AS\nand correlate BGP routing information between AS.\n\nWhen querying an IP to find which AS (Autonomous System), it is helpful\nto find associated IP addresses. The AS is part of the BGP routing for that IP.\nTo return the AS information for an IP, use the endpoint /bgp_routes/ip/.\nA valid result returns an array of hash references.\nThe hash reference contains information about the AS such as the ASN,\nthe CIDR prefix of the AS, the Internet Registry (RIR) number (0 through 6),\nthe Description of the AS and the creation date for the AS.\nAn empty response returns an empty array ([]).","parameters":[{"name":"ip","in":"path","required":true,"description":"IPv4 IP address for which to obtain the AS information","schema":{"type":"string"}}],"responses":{"200":{"description":"Success. Returns data about ASN & IP relationships.","content":{"application/json":{"schema":{"type":"object","properties":{"creation_date":{"type":"string","description":"Date when AS was first created."},"ir":{"type":"integer","description":"The IR number corresponds to one of the 5 Regional Internet Registries (RIR).\n| Registry | Number |\tRegion |\n|-----|-----|-----|\n| Registry | 1 | AfriNIC: Africa |\n| Registry | 2 | APNIC: Asia, Australia, New Zealand, and neighboring countries. |\n| Registry | 3 | ARIN: United States, Canada, several parts of the Caribbean region, and Antarctica. |\n| Registry | 4 | LACNIC: Latin America and parts of the Caribbean region. |\n| Registry | 5 | RIPE NCC: Europe, Russia, the Middle East, and Central Asia. |\n| Registry | 0 | Unknown / Not Available |"},"description":{"type":"string","description":"Network Owner Description as provided by the network owner."},"asn":{"type":"string","description":"Autonomous System Number (ASN) associated with this IP address."},"cidr":{"type":"string","description":"IP CIDR for the ASN."}}},"example":{"creation_date":"2002-08-01","ir":2,"description":"CHINANET-BACKBONE No.31,Jin-rong Street,CN 86400","asn":"4134","cidr":"123.172.0.0/15"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/400Error"},"401":{"description":"Unauthorized request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/401Error"},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/403Error"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/404Error"},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/500Error"}},"__originalOperationId":"getBgpRoutesIp","security":[{"bearerAuth":[]}],"method":"get","path":"/bgp_routes/ip/{ip}/as_for_ip.json"}}