{"uid":"cap_zILBnJrk0uRTM2HIBwgQt","slug":"dev-reference-tcp-udp-port-lookup-da0a2c02","name":"Dev Reference: TCP/UDP Port Lookup","description":"IANA service name and common use for a TCP/UDP port (about 130 well-known ports), plus the port range class.","url":"https://dev-reference.x402tookit.com/port-lookup?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["port"],"properties":{"port":{"type":"integer","description":"Port number, 0 to 65535"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"port":{"type":["null","number"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"ianaRows":{"type":["array","null"],"items":{"type":"object","properties":{"service":{"type":["null","string"]},"protocol":{"type":["null","string"]},"description":{"type":["null","string"]}}}},"commonUse":{"type":["null","string"]},"protocols":{"type":["array","null"],"items":{"type":"string"}},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"rangeClass":{"type":["null","string"]},"ianaAssigned":{"type":["boolean","null"]},"ianaServices":{"type":["array","null"],"items":{"type":"string"}},"ianaDescription":{"type":["null","string"]},"officialAndCommonUseDiffer":{"type":["boolean","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hBtoYzN8O6r4DOxSqjb9S","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the IANA service name, common use description, supported protocols, and port range class for any TCP/UDP port number (0–65535)","exampleAgentPrompt":"What IANA service is registered on port 5432, what is it commonly used for, and what port range class does it fall into?","exampleUseCases":[{"title":"Security audit of open ports","prompt":"I'm reviewing our firewall rules and need to know what port 3389 is officially registered as by IANA, what it's commonly used for, and whether it's in the well-known, registered, or dynamic port range."},{"title":"Debugging unknown service traffic","prompt":"We're seeing unexpected traffic on port 6379 in our logs — can you tell me the IANA service name, what protocol it uses, and what it's typically used for in practice?"},{"title":"Developer documentation for internal service","prompt":"I'm writing docs for our internal platform that runs on port 8080. What's the official IANA assignment and common use for that port, and does it differ from the official description?"}],"resultDescription":"Returns a structured object including: the port number, IANA-registered service name(s), IANA description, common real-world use, supported protocols (TCP/UDP), port range class (well-known 0–1023, registered 1024–49151, or dynamic/private 49152–65535), whether the port is IANA-assigned, a verdict and reasons, and a flag indicating if official and common use differ. May include a degraded flag and disclaimer if data is partial.","failureModes":["Port number out of range (not 0–65535) returns a validation error","Port not in the ~130 well-known port dataset may return null or sparse fields with degraded=true","Network timeout or upstream unavailability returns a service error","Missing required 'port' query parameter returns a 400-level error"],"whenToPreferThis":"Choose this endpoint when you need authoritative IANA port assignments and common-use descriptions for well-known ports (roughly the top 130), including whether official and de-facto usage differ. It is purpose-built for developer reference and security tooling, returning structured metadata with range classification, protocols, and verdict reasoning — making it more useful than a plain text lookup when you need machine-readable output for downstream logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:36:02.200Z","isFirstParty":false,"canonicalSlug":"dev-reference-tcp-udp-port-lookup-da0a2c02"}