{"uid":"cap_WO_9scnj5k2ajkCbbk9sC","slug":"agenttoll-postal-lookup-65414710","name":"AgentToll Postal Lookup","description":"108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.","url":"https://agenttoll.dev/paid/gov/postal-lookup","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"country":{"type":"string","description":"2-letter ISO code e.g. US, GB, DE"},"postal_code":{"type":"string","description":"string postal code"}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_TKP-pak-MfrDzrVf7Cxqz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up geographic and administrative data for a postal code in a given country","exampleAgentPrompt":"Can you look up what city and region postal code 90210 is in for the US?","exampleUseCases":[{"title":"Validate e-commerce shipping address","prompt":"I have a customer order with postal code SW1A 1AA in GB — can you confirm what city and region that maps to so I can verify the shipping address?"},{"title":"Enrich user profile with location","prompt":"A user signed up with postal code 10001 and country US — look up the city and state for that zip code so I can fill in their profile location."},{"title":"Resolve German postal code for logistics","prompt":"I need to know which city and state the German postal code 80331 belongs to for a delivery route I'm planning."}],"resultDescription":"Returns geographic and administrative data for the given postal code, including city name, state or region, and potentially geographic coordinates. The response is a JSON object with location fields derived from official postal data.","failureModes":["Invalid or non-existent postal code returns error or empty result","Unsupported country code may yield no data","Malformed country code (not 2-letter ISO) causes validation error","Payment failure via x402 prevents the call from executing","Postal code format mismatch for the given country (e.g. wrong length) may return no match"],"whenToPreferThis":"Choose this endpoint when you need to resolve a postal code to city/region data for any supported country, especially in agentic workflows where per-call micropayments via USDC on Base are acceptable. It is well-suited for address enrichment, shipping validation, or geographic lookups across multiple countries without needing a dedicated geocoding API subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:40:19.452Z","isFirstParty":false}