{"openapi":"3.1.0","info":{"title":"IP Protocol Numbers API","version":"1.0.0","description":"The IANA \"Assigned Internet Protocol Numbers\" registry as an API — the 8-bit value carried in the IPv4 Protocol field (and IPv6 Next Header) that identifies the encapsulated protocol. Resolve any number to its protocol (e.g. 6 → TCP, 17 → UDP, 1 → ICMP, 47 → GRE, 50 → ESP, 58 → IPv6-ICMP, 89 → OSPF, 132 → SCTP), look up by keyword, search by name, or list all 151 assigned protocols — each with its keyword, full name, IPv6-extension-header flag and defining RFC. Ideal for packet/firewall tooling, network analysis, NetFlow/IPFIX decoders and protocol documentation. (Distinct from transport-layer service port numbers.)","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ipprotocols-api","description":"oanor gateway"}],"tags":[{"name":"IP Protocols"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/list":{"get":{"operationId":"get_v1_list","tags":["IP Protocols"],"summary":"All protocol numbers","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max results (1-256, default 50)","schema":{"type":"string"},"example":"50"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"limit":50,"total":151,"offset":0,"results":[{"name":"IPv6 Hop-by-Hop Option","number":0,"keyword":"HOPOPT","reference":"[RFC8200]","ipv6_extension_header":true},{"name":"Internet Control Message","number":1,"keyword":"ICMP","reference":"[RFC792]","ipv6_extension_header":false},{"name":"Internet Group Management","number":2,"keyword":"IGMP","reference":"[RFC1112]","ipv6_extension_header":false},{"name":"Gateway-to-Gateway","number":3,"keyword":"GGP","reference":"[RFC823]","ipv6_extension_header":false},{"name":"IPv4 encapsulation","number":4,"keyword":"IPv4","reference":"[RFC2003]","ipv6_extension_header":false},{"name":"Stream","number":5,"keyword":"ST","reference":"[RFC1190][RFC1819]","ipv6_extension_header":false},{"name":"Transmission Control","number":6,"keyword":"TCP","reference":"[RFC9293]","ipv6_extension_header":false},{"name":"CBT","number":7,"keyword":"CBT","reference":"[Tony_Ballardie]","ipv6_extension_header":false},{"name":"Exterior Gateway Protocol","number":8,"keyword":"EGP","reference":"[RFC888][David_Mills]","ipv6_extension_header":false},{"name":"any private interior gateway             \n(used by Cisco for their IGRP)","number":9,"keyword":"IGP","reference":"[Internet_Assigned_Numbers_Authority]","ipv6_extension_header":false},{"name":"BBN RCC Monitoring","number":10,"keyword":"BBN-RCC-MON","reference":"[Steve_Chipman]","ipv6_extension_header":false},{"name":"Network Voice Protocol","number":11,"keyword":"NVP-II","reference":"[RFC741][Steve_Casner]","ipv6_extension_header":false},{"name":"PUP","number":12,"keyword":"PUP","reference":"[Boggs, D., J. Shoch, E. Taft, and R. Metcalfe, \"PUP: An Internetwork Architecture\", XEROX Palo Alto Research Center, CSL-79-10, July 1979; also in IEEE Transactions on Communication, Volume COM-28, Number 4, April 1980.][[XEROX]]","ipv6_extension_header":false},{"name":"ARGUS","number":13,"keyword":"ARGUS (deprecated)","reference":"[Robert_W_Scheifler]","ipv6_extension_header":false},{"name":"EMCON","number":14,"keyword":"EMCON","reference":"[Bich_Nguyen]","ipv6_extension_header":false},{"name":"Cross Net Debugger","number":15,"keyword":"XNET","reference":"[Haverty, J., \"XNET Formats for Internet Protocol Version 4\", IEN 158, October 1980.][Jack_Haverty]","ipv6_extension_header":false},{"name":"Chaos","number":16,"keyword":"CHAOS","reference":"[J_Noel_Chiappa]","ipv6_extension_header":false},{"name":"User Datagram","number":17,"keyword":"UDP","reference":"[RFC768][Jon_Postel]","ipv6_extension_header":false},{"name":"Multiplexing","number":18,"keyword":"MUX","reference":"[Cohen, D. and J. Postel, \"Multiplexing Protocol\", IEN 90, USC/Information Sciences Institute, May 1979.][Jon_Postel]","ipv6_extension_header":false},{"name":"DCN Measurement Subsystems","number":19,"keyword":"DCN-MEAS","reference":"[David_Mills]","ipv6_extension_header":false},{"name":"Host Monitoring","number":20,"keyword":"HMP","reference":"[RFC869][Bob_Hinden]","ipv6_extension_header":false},{"name":"Packet Radio Measurement","number":21,"keyword":"PRM","reference":"[Zaw_Sing_Su]","ipv6_extension_header":false},{"name":"XEROX NS IDP","number":22,"keyword":"XNS-IDP","reference":"[\"The Ethernet, A Local Area Network: Data Link Layer and Physical Layer Specification\", AA-K759B-TK, Digital Equipment Corporation, Maynard, MA. Also as: \"The Ethernet - A Local Area Network\", Version 1.0, Digital Equipment Corporation, Intel Corporation, Xerox Corporation, September 1980. And: \"The Ethernet, A Local Area Network: Data Link Layer and Physical Layer Specifications\", Digital, Intel and Xerox, November 1982. And: XEROX, \"The Ethernet, A Local Area Network: Data Link Layer and Physical Layer Specification\", X3T51/80-50, Xerox Corporation, Stamford, CT., October 1980.][[XEROX]]","ipv6_extension_header":false},{"name":"Trunk-1","number":23,"keyword":"TRUNK-1","reference":"[Barry_Boehm]","ipv6_extension_header":false},{"name":"Trunk-2","number":24,"keyword":"TRUNK-2","reference":"[Barry_Boehm]","ipv6_extension_header":false},{"name":"Leaf-1","number":25,"keyword":"LEAF-1","reference":"[Barry_Boehm]","ipv6_extension_header":false},{"name":"Leaf-2","number":26,"keyword":"LEAF-2","reference":"[Barry_Boehm]","ipv6_extension_header":false},{"name":"Reliable Data Protocol","number":27,"keyword":"RDP","reference":"[RFC908][Bob_Hinden]","ipv6_extension_header":false},{"name":"Internet Reliable Transaction","number":28,"keyword":"IRTP","reference":"[RFC938][Trudy_Miller]","ipv6_extension_header":false},{"name":"ISO Transport Protocol Class 4","number":29,"keyword":"ISO-TP4","reference":"[RFC905][Robert_Cole]","ipv6_extension_header":false},{"name":"Bulk Data Transfer Protocol","number":30,"keyword":"NETBLT","reference":"[RFC969][David_Clark]","ipv6_extension_header":false},{"name":"MFE Network Services Protocol","number":31,"keyword":"MFE-NSP","reference":"[Shuttleworth, B., \"A Documentary of MFENet, a National Computer Network\", UCRL-52317, Lawrence Livermore Labs, Livermore, California, June 1977.][Barry_Howard]","ipv6_extension_header":false},{"name":"MERIT Internodal Protocol","number":32,"keyword":"MERIT-INP","reference":"[Hans_Werner_Braun]","ipv6_extension_header":false},{"name":"Datagram Congestion Control Protocol","number":33,"keyword":"DCCP","reference":"[RFC4340]","ipv6_extension_header":false},{"name":"Third Party Connect Protocol","number":34,"keyword":"3PC","reference":"[Stuart_A_Friedberg]","ipv6_extension_header":false},{"name":"Inter-Domain Policy Routing Protocol","number":35,"keyword":"IDPR","reference":"[Martha_Steenstrup]","ipv6_extension_header":false},{"name":"XTP","number":36,"keyword":"XTP","reference":"[Greg_Chesson]","ipv6_extension_header":false},{"name":"Datagram Delivery Protocol","number":37,"keyword":"DDP","reference":"[Wesley_Craig]","ipv6_extension_header":false},{"name":"IDPR Control Message Transport Proto","number":38,"keyword":"IDPR-CMTP","reference":"[Martha_Steenstrup]","ipv6_extension_header":false},{"name":"TP++ Transport Protocol","number":39,"keyword":"TP++","reference":"[Dirk_Fromhein]","ipv6_extension_header":false},{"name":"IL Transport Protocol","number":40,"keyword":"IL","reference":"[Dave_Presotto]","ipv6_extension_header":false},{"name":"IPv6 encapsulation","number":41,"keyword":"IPv6","reference":"[RFC2473]","ipv6_extension_header":false},{"name":"Source Demand Routing Protocol","number":42,"keyword":"SDRP","reference":"[Deborah_Estrin]","ipv6_extension_header":false},{"name":"Routing Header for IPv6","number":43,"keyword":"IPv6-Route","reference":"[Steve_Deering]","ipv6_extension_header":true},{"name":"Fragment Header for IPv6","number":44,"keyword":"IPv6-Frag","reference":"[Steve_Deering]","ipv6_extension_header":true},{"name":"Inter-Domain Routing Protocol","number":45,"keyword":"IDRP","reference":"[Sue_Hares]","ipv6_extension_header":false},{"name":"Reservation Protocol","number":46,"keyword":"RSVP","reference":"[RFC2205][RFC3209][Bob_Braden]","ipv6_extension_header":false},{"name":"Generic Routing Encapsulation","number":47,"keyword":"GRE","reference":"[RFC2784][Tony_Li]","ipv6_extension_header":false},{"name":"Dynamic Source Routing Protocol","number":48,"keyword":"DSR","reference":"[RFC4728]","ipv6_extension_header":false},{"name":"BNA","number":49,"keyword":"BNA","reference":"[Gary Salamon]","ipv6_extension_header":false}]},"meta":{"timestamp":"2026-05-31T07:00:19.503Z","request_id":"8192146c-a104-4911-bf85-66c840438293"},"status":"ok","message":"Protocols listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/protocol":{"get":{"operationId":"get_v1_protocol","tags":["IP Protocols"],"summary":"A protocol by number or keyword","description":"","parameters":[{"name":"number","in":"query","required":false,"description":"Protocol number, e.g. 6 (TCP)","schema":{"type":"string"},"example":"6"},{"name":"keyword","in":"query","required":false,"description":"Keyword, e.g. TCP","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Transmission Control","number":6,"keyword":"TCP","reference":"[RFC9293]","ipv6_extension_header":false},"meta":{"timestamp":"2026-05-31T07:00:19.577Z","request_id":"32d7e330-0e06-413b-9ad2-46787d60c531"},"status":"ok","message":"Protocol retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["IP Protocols"],"summary":"Search protocols by keyword or name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term, e.g. routing","schema":{"type":"string"},"example":"routing"},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"limit":20,"query":"routing","total":6,"offset":0,"results":[{"name":"Inter-Domain Policy Routing Protocol","number":35,"keyword":"IDPR","reference":"[Martha_Steenstrup]","ipv6_extension_header":false},{"name":"Source Demand Routing Protocol","number":42,"keyword":"SDRP","reference":"[Deborah_Estrin]","ipv6_extension_header":false},{"name":"Routing Header for IPv6","number":43,"keyword":"IPv6-Route","reference":"[Steve_Deering]","ipv6_extension_header":true},{"name":"Inter-Domain Routing Protocol","number":45,"keyword":"IDRP","reference":"[Sue_Hares]","ipv6_extension_header":false},{"name":"Generic Routing Encapsulation","number":47,"keyword":"GRE","reference":"[RFC2784][Tony_Li]","ipv6_extension_header":false},{"name":"Dynamic Source Routing Protocol","number":48,"keyword":"DSR","reference":"[RFC4728]","ipv6_extension_header":false}]},"meta":{"timestamp":"2026-05-31T07:00:19.635Z","request_id":"23176dfc-7415-4749-a166-ae11cd7db21a"},"status":"ok","message":"Protocols listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The 8-bit Protocol field (IPv4) / Next Header (IPv6). E.g. 6 = TCP, 17 = UDP, 1 = ICMP. Distinct from transport-layer service ports.","total":151,"fields":["number","keyword","name","ipv6_extension_header","reference"],"source":"IANA Assigned Internet Protocol Numbers","assigned":144},"meta":{"timestamp":"2026-05-31T07:00:19.712Z","request_id":"a09e7f60-c2ef-40f6-9ebe-98e8c70a76da"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":25000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":150,"monthly_call_quota":200000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":450,"monthly_call_quota":900000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":1400,"monthly_call_quota":4500000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ipprotocols-api"}