{"uid":"cap_s0NsUg-a5BCn_iwTfE5r5","slug":"uk-postcode-autocomplete-api-05ca5552","name":"UK Postcode Autocomplete API","description":"UK postcode lookup, search, validation and autocomplete with x402 payments.","url":"https://postcode.payapi.market/lookup/autocomplete?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of suggestions to return (1-100, default 10)."},"partial":{"type":"string","description":"Partial UK postcode to autocomplete, e.g. 'SW1A'."}}},"responseSchema":{"type":"json","example":{"count":3,"partial":"SW1A","suggestions":["SW1A 0AA","SW1A 1AA","SW1A 2AA"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__k97hn7aE2vkQTV0W1_3V","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of matching UK postcode suggestions given a partial postcode string","exampleAgentPrompt":"Can you suggest up to 10 UK postcodes that start with 'SW1A' so I can show the user a dropdown of matching options?","exampleUseCases":[{"title":"Address form postcode typeahead","prompt":"As the user types 'EC1A' into the postcode field on our checkout form, give me up to 20 matching UK postcode suggestions to show in the dropdown."},{"title":"Validate and complete a partial postcode","prompt":"The user entered 'W1F' as their postcode — can you return up to 5 full UK postcodes that start with that prefix so they can pick the right one?"},{"title":"Postcode lookup for delivery routing","prompt":"I need a list of all UK postcodes beginning with 'M1' — return up to 50 suggestions so I can let the driver pick the correct delivery area."}],"resultDescription":"A JSON object containing the original partial postcode, a count of suggestions returned, and an array of matching full UK postcode strings (e.g. ['SW1A 0AA', 'SW1A 1AA', 'SW1A 2AA'])","failureModes":["Empty or missing 'partial' field returns no suggestions or an error","Limit outside 1–100 range is rejected or clamped","Non-UK postcode prefixes return zero suggestions","Payment failure via x402 results in 402 response and no data returned","Very broad partial (e.g. single letter) may return truncated results at the limit"],"whenToPreferThis":"Choose this endpoint when you need real-time UK postcode autocompletion or typeahead suggestions from a partial prefix — ideal for building address forms, validating user input incrementally, or helping users narrow down a correct UK postcode without knowing the full code.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:38:14.314Z","isFirstParty":false,"canonicalSlug":"uk-postcode-autocomplete-api-05ca5552"}