{"uid":"cap_CI6Z4fmKX-b8k9zuNPcsk","slug":"ipv6-address-expander-and-canonical-compressor-9d3ecb02","name":"IPv6 Address Expander and Canonical Compressor","description":"Return both the fully-expanded (eight 4-hex groups) and canonical compressed (RFC 5952) forms of an address. IPv4 is returned unchanged in both fields.","url":"https://ip.openverbs.com/v1/expand","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["address"],"properties":{"address":{"type":"string","maxLength":64,"minLength":1,"description":"IPv4 or IPv6 address."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RRtAgCQVFU_J-a81WR5Oe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Expands an IPv4 or IPv6 address into its fully-expanded eight 4-hex-group form and returns the RFC 5952 canonical compressed representation.","exampleAgentPrompt":"Can you expand the IPv6 address 2001:db8::1 into its full eight-group notation and also give me the RFC 5952 canonical compressed form?","exampleUseCases":[{"title":"Normalize IPv6 for database storage","prompt":"I need to normalize the IPv6 address fe80::1ff:fe23:4567:890a into both its fully expanded form and its canonical compressed RFC 5952 form before I store it in our database."},{"title":"Debug compressed IPv6 shorthand","prompt":"Can you expand ::ffff:192.0.2.1 into the complete eight 4-hex-group notation so I can see every group explicitly and compare it against our firewall rules?"},{"title":"Validate display format for network logs","prompt":"I have the address 2001:db8:0:0:1:0:0:1 — can you give me both the fully expanded version and the proper RFC 5952 compressed canonical form so our log parser handles it correctly?"}],"resultDescription":"Returns two string fields: the fully-expanded IPv6 address (all eight 4-hex groups, e.g. '2001:0db8:0000:0000:0000:0000:0000:0001') and the RFC 5952 canonical compressed form (e.g. '2001:db8::1'). For IPv4 addresses, both fields return the original address unchanged.","failureModes":["Empty or missing 'address' field returns a validation error","Malformed address string (not valid IPv4 or IPv6) returns an error response","Address string exceeding 64 characters is rejected by schema validation","Payment failure or insufficient USDC balance causes an HTTP 402 error"],"whenToPreferThis":"Choose this endpoint when you need to normalize or canonicalize IPv6 addresses for storage, comparison, display, or logging — particularly when you need both the fully-expanded and the RFC 5952 compressed forms simultaneously. It handles edge cases like IPv4-mapped IPv6 addresses and is purpose-built for IP address formatting rather than a general-purpose utility.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:34:25.656Z","isFirstParty":false}