[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"api-page:us-zip-code-radius-and-lookup-api":3},{"status":4,"api":5,"seo":312},"success",{"blocked":6,"description":7,"about":8,"stats":9,"name":11,"title":12,"slug":13,"logo":14,"created_at":15,"agent":16,"user":28,"endpoint_groups":31,"faqs":253,"features":260,"periodic_plans":265,"payasyougo_plans":311},false,"U.S. ZIP code lookup, radius search, and distance API for fast and accurate geolocation. Instantly retrieve ZIP code details, find nearby ZIPs within a radius, calculate distances between ZIP codes, autocomplete ZIP inputs, and map cities to ZIPs. Designed for delivery zones, store locators, logistics platforms, and location-based services.","## 📍 **US Zip Code Radius & Lookup API**\n\n**USPS-Verified US Zip Code Database for location intelligence, distance calculation, and geolocation services.**\nPower your store locators, delivery range calculators, logistics platforms, and location-based applications with USPS-verified ZIP code data and distance matrix calculations. Updated monthly with official USPS data.\n\n---\n\n### 🚀 **Key Features**\n\n* ✅ **USPS-Verified Data** – 43,600+ ZIP codes verified against official USPS standards. Updated monthly for accuracy and compliance.\n* ✅ **Radius Search** – Find all ZIP codes within X miles/km of a location. Perfect for store locators and delivery range calculators.\n* ✅ **Distance Calculation** – Calculate accurate distance between two ZIP codes for logistics and route planning.\n* ✅ **ZIP Code Lookup** – Get city and state information for any valid U.S. ZIP code from our comprehensive database.\n* ✅ **City to ZIP Codes** – Retrieve all ZIP codes for a specific city and state. Essential for geolocation services.\n* ✅ **Smart Autocomplete** – Real-time ZIP code suggestions for better UX in forms and search interfaces.\n* ✅ **Developer Friendly** – Always returns 200 OK (no 404 errors) for safer client-side integration and predictable error handling.\n\n---\n\n### 💡 **Top Use Cases**\n\n* 🛒 **Store Locator** – Build store finder widgets that show nearby locations using radius search and distance matrix.\n* 🚚 **Logistics & Delivery** – Define delivery zones, calculate shipping costs, and optimize routes based on ZIP code distance.\n* 🧠 **Lead Routing** – Automatically assign sales or service territories using geolocation data.\n* 📦 **E-commerce Checkout** – Validate ZIP codes, estimate delivery times, and show accurate shipping information.\n* 📊 **Data Enrichment** – Enhance customer databases with location intelligence and geographic segmentation.\n* 🗺️ **Service Area Mapping** – Define coverage areas for field services, delivery drivers, or sales territories.\n\n---\n\n### ⚙️ **Endpoints Overview**\n\n| Endpoint                                | Method | Description                         |\n| --------------------------------------- | ------ | ----------------------------------- |\n| `/api/zipcode/{zip}`                    | `GET`  | Get city, state info for ZIP      |\n| `/api/zipcodes/radius?zipcode={zipcode}&radius={radius}&unit={unit}` | `GET`  | Get ZIP codes within a radius     |\n| `/api/distance?from={from_zip}&to={to_zip}&unit={unit}`         | `GET`  | Calculate distance between two ZIPs |\n| `/api/zipcodes/by-city?city={city_name}&state={state_abbreviation}`   | `GET`  | List ZIP codes in a city/state      |\n| `/api/zipcodes/autocomplete?q={query_string}`                | `GET`  | Suggest ZIPs based on partial input |\n\n---\n\n### 🧰 **Technical Details**\n\n* ✅ **Data Quality**: USPS-verified, updated monthly\n* ✅ **Coverage**: 43,600+ active US ZIP codes\n* ✅ **HTTP Method**: `GET` (fully RESTful)\n* ✅ **Response**: JSON\n* ✅ **Units**: `mi` or `km` supported\n* ✅ **Latency**: < 300ms typical\n* ✅ **Caching**: Safe for most use cases (read-heavy)\n* ✅ **Reliability**: 100% - Returns 200 OK for all successful requests (even when data not found)\n\n---\n\n### 🌐 **Why Choose This API?**\n\n* 🏛️ **USPS-Verified** – Official data source, updated monthly with high accuracy\n* 📊 **Comprehensive Coverage** – 43,600+ active US ZIP codes\n* 📈 **Developer-Friendly** – Intuitive response structure with clear `success` and `found` indicators\n* 🚀 **Fast Response Times** – Sub-300ms latency for most queries\n* 💡 **Easy Integration** – Plug-and-play for frontend apps and backends\n* 🔄 **Modern Architecture** – Works seamlessly with serverless, Jamstack, and SaaS platforms\n* 🎯 **Enterprise-Ready** – Consistent error handling and response formats across all endpoints\n\n---\n\n### 📦 **Response Structure**\n\nOur API uses a standardized response format that makes client-side handling straightforward and predictable.\n\n**For Successful Searches (Data Found):**\n- Returns HTTP 200 with `success: true` and `found: true`\n- Includes requested data with metadata (timestamp only)\n- Consistent structure across all endpoints\n\n**Example:**\n```json\n{\n  \"metadata\": {\n    \"timestamp\": \"2025-01-10T12:34:56.789Z\"\n  },\n  \"success\": true,\n  \"found\": true,\n  \"data\": {\n    \"zipcode\": \"90210\",\n    \"cities\": [\n      {\n        \"city\": \"Beverly Hills\",\n        \"state\": \"California\",\n        \"stateAbbreviation\": \"CA\"\n      }\n    ]\n  }\n}\n```\n\n**For Valid Searches (No Data Found):**\n- Returns HTTP 200 with `success: true` and `found: false`\n- Includes helpful message explaining what wasn't found\n- Empty data field (null or empty array depending on endpoint)\n\n**Example:**\n```json\n{\n  \"metadata\": {\n    \"timestamp\": \"2025-01-10T12:34:56.789Z\"\n  },\n  \"success\": true,\n  \"found\": false,\n  \"data\": null,\n  \"message\": \"No information found for zip code: 99999\"\n}\n```\n\n**For Invalid Requests:**\n- Returns HTTP 400 with error details\n- Clear error messages explaining what's wrong\n- Validation errors caught early\n\n**Example:**\n```json\n{\n  \"error\": {\n    \"message\": \"Invalid zip code format. Must be 5 digits.\",\n    \"status\": 400,\n    \"timestamp\": \"2025-01-10T12:34:56.789Z\"\n  }\n}\n```\n\n**Key Advantages:**\n- **Simple Logic** – Just check `response.found` to see if data exists\n- **No Exception Handling** – Missing data isn't an error, it's a valid result\n- **Better UX** – Distinguish between \"no results\" and actual errors\n- **Perfect Metrics** – Only real failures affect your reliability score\n- **Type-Safe** – Predictable structure makes TypeScript/validation easy\n\n---\n\n**Build smarter location-based experiences with the US Zip Code Radius & Lookup API — start integrating in minutes.**",{"score":10},"2.38","US Zip Code Radius and Lookup","US Zip Code Radius and Lookup API","us-zip-code-radius-and-lookup-api","https://cdn.jojapi.com/api/f6f077a0-ed17-4e33-bbc1-98e7f36a1068","2026-09-09 08:46:08",{"enabled":17,"closed":18,"request_enabled":6,"catalog_url":19,"discovery_url":20,"directory_url":21,"rails":22,"networks":25,"docs":27},true,null,"https://wxtfd.jojapi.net/_jojapi/agent/plans","https://wxtfd.jojapi.net/.well-known/x402","https://agents.jojapi.net/apis/us-zip-code-radius-and-lookup-api",[23,24],"x402","mpp",[26],"eip155:8453","https://docs.jojapi.com/consumers/agents",{"nick":29,"name":30,"verified":6,"website":18},"payloadic","Payloadic",[32],{"endpoints":33,"name":252,"description":40,"ungrouped":6,"open":6},[34,104,148,185,218],{"blocked":6,"hidden":6,"agent_price":18,"credits":18,"flexible_credits_description":18,"consumptions":35,"description":42,"method":43,"name":44,"url_path":45,"root_url":46,"parameters":47,"responses":74,"result_stats":98},[36],{"name":37,"slug":38,"cost":39,"label":40,"avg":41},"Requests","requests","1","",1,"Computes the geographical distance between two specified US zip codes, returning the value in either miles or kilometers.","GET","Distance Between Two Zip Codes","/zipcode/v1/distance","https://wxtfd.jojapi.net",{"url":48,"header":65,"post":71,"body":72,"path":73},[49,54,58],{"key":50,"example":51,"schema":18,"example_disabled":6,"example_type":52,"value_type":52,"enum_values":18,"default_value":40,"required":17,"name":40,"description":53},"from","90210","string","The originating US zip code.",{"key":55,"example":56,"schema":18,"example_disabled":6,"example_type":52,"value_type":52,"enum_values":18,"default_value":40,"required":17,"name":40,"description":57},"to","94107","The destination US zip code.",{"key":59,"example":40,"schema":18,"example_disabled":6,"example_type":52,"value_type":60,"enum_values":61,"default_value":62,"required":6,"name":40,"description":64},"unit","enum",[62,63],"mi","km","The unit of measurement for the distance. Defaults to 'mi' (miles) if not specified.",[66],{"key":67,"is_auth":17,"example":68,"example_disabled":17,"example_type":52,"name":69,"description":68,"required":17,"always_error":70},"X-JoJAPI-Key","You must log in to get API key","JoJ API Key","Please log in to get API key",[],[],[],[75,84,92],{"status":76,"status_code":77,"description":78,"schema":79,"examples":80,"example":83},"200",200,"Successful response with the calculated distance, or empty result if zip codes not found.","{\"type\":\"object\",\"description\":\"Successful response wrapper with metadata for distance calculation.\",\"properties\":{\"metadata\":{\"type\":\"object\",\"properties\":{\"timestamp\":{\"type\":\"string\",\"format\":\"date-time\"}},\"required\":[\"timestamp\"]},\"success\":{\"type\":\"boolean\",\"description\":\"Indicates the API call succeeded.\"},\"found\":{\"type\":\"boolean\",\"description\":\"Indicates whether the requested data was found.\"},\"data\":{\"type\":\"object\",\"description\":\"Represents the calculated distance between two zip codes.\",\"properties\":{\"distance\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The calculated distance between the two zip codes.\",\"minimum\":-3.402823669209385e+38,\"maximum\":3.402823669209385e+38},\"unit\":{\"type\":\"string\",\"enum\":[\"mi\",\"km\"],\"description\":\"The unit of measurement for the distance (miles or kilometers).\"}},\"required\":[\"distance\",\"unit\"]}},\"required\":[\"metadata\",\"success\",\"found\",\"data\"]}",[81],{"name":82,"summary":82,"description":40,"example":83},"Example_1","{\"metadata\":{\"timestamp\":\"\"},\"success\":true,\"found\":true,\"data\":{\"distance\":347.5,\"unit\":\"mi\"}}",{"status":85,"status_code":86,"description":87,"schema":88,"examples":89,"example":91},"400",400,"Invalid request, e.g., missing 'from' or 'to' zip codes.","{\"type\":\"object\",\"properties\":{\"message\":{\"type\":\"string\",\"description\":\"A human-readable message describing the error.\"},\"status\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The HTTP status code.\",\"minimum\":-2147483648,\"maximum\":2147483647},\"timestamp\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The time the error occurred.\"}},\"required\":[\"message\",\"status\",\"timestamp\"]}",[90],{"name":82,"summary":82,"description":40,"example":91},"{\"message\":\"\",\"status\":0,\"timestamp\":\"\"}",{"status":93,"status_code":94,"description":95,"schema":88,"examples":96,"example":91},"500",500,"Internal Server Error.",[97],{"name":82,"summary":82,"description":40,"example":91},{"x2":99,"x3":100,"x4":101,"x5":101,"uptime":102,"avg_latency":103,"avg_credits":101},"80.00","20.00","0.00","100.00","781",{"blocked":6,"hidden":6,"agent_price":18,"credits":18,"flexible_credits_description":18,"consumptions":105,"description":107,"method":43,"name":108,"url_path":109,"root_url":46,"parameters":110,"responses":128,"result_stats":142},[106],{"name":37,"slug":38,"cost":39,"label":40,"avg":41},"Retrieves a list of US zip codes that fall within a specified radius (in miles or kilometers) of a given origin US zip code.","Zip Codes In Radius","/zipcode/v1/radius",{"url":111,"header":123,"post":125,"body":126,"path":127},[112,115,120],{"key":113,"example":51,"schema":18,"example_disabled":6,"example_type":52,"value_type":52,"enum_values":18,"default_value":40,"required":17,"name":40,"description":114},"zipcode","The origin US zip code for the radius search.",{"key":116,"example":117,"schema":18,"example_disabled":6,"example_type":52,"value_type":118,"enum_values":18,"default_value":40,"required":17,"name":40,"description":119},"radius","10","number","The radius for the search. Must be a positive number. Max 200 mi or 320 km.",{"key":59,"example":40,"schema":18,"example_disabled":6,"example_type":52,"value_type":60,"enum_values":121,"default_value":62,"required":6,"name":40,"description":122},[62,63],"The unit of measurement for the radius. Defaults to 'mi' (miles).",[124],{"key":67,"is_auth":17,"example":68,"example_disabled":17,"example_type":52,"name":69,"description":68,"required":17,"always_error":70},[],[],[],[129,135,139],{"status":76,"status_code":77,"description":130,"schema":131,"examples":132,"example":134},"Successful response with a list of zip codes within the radius, or empty array if origin not found or no results.","{\"type\":\"object\",\"description\":\"Successful response wrapper with metadata for radius search.\",\"properties\":{\"metadata\":{\"type\":\"object\",\"properties\":{\"timestamp\":{\"type\":\"string\",\"format\":\"date-time\"}},\"required\":[\"timestamp\"]},\"success\":{\"type\":\"boolean\",\"description\":\"Indicates the API call succeeded.\"},\"found\":{\"type\":\"boolean\",\"description\":\"Indicates whether the requested data was found.\"},\"data\":{\"type\":\"object\",\"description\":\"Represents the response for a zip code radius search.\",\"properties\":{\"originZipcode\":{\"type\":\"string\",\"description\":\"The zip code used as the center of the radius search.\"},\"radius\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The radius used for the search, in the unit specified.\",\"minimum\":-3.402823669209385e+38,\"maximum\":3.402823669209385e+38},\"unit\":{\"type\":\"string\",\"enum\":[\"mi\",\"km\"],\"description\":\"The unit of measurement for the radius and distances.\"},\"zipcodes\":{\"type\":\"array\",\"description\":\"A list of zip codes found within the specified radius.\",\"items\":{\"type\":\"object\",\"description\":\"Represents a zip code found within a specified radius, including its distance from the origin.\",\"properties\":{\"city\":{\"type\":\"string\",\"description\":\"The city name associated with the zip code.\"},\"zipcode\":{\"type\":\"string\",\"description\":\"The zip code identifier.\"},\"distance\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The distance from the origin zip code, in the unit specified in the request.\",\"minimum\":-3.402823669209385e+38,\"maximum\":3.402823669209385e+38}},\"required\":[\"city\",\"zipcode\",\"distance\"]}}},\"required\":[\"originZipcode\",\"radius\",\"unit\",\"zipcodes\"]}},\"required\":[\"metadata\",\"success\",\"found\",\"data\"]}",[133],{"name":82,"summary":82,"description":40,"example":134},"{\"metadata\":{\"timestamp\":\"\"},\"success\":true,\"found\":true,\"data\":{\"originZipcode\":\"90210\",\"radius\":10,\"unit\":\"mi\",\"zipcodes\":[{\"city\":\"Santa Monica\",\"zipcode\":\"90401\",\"distance\":5.25}]}}",{"status":85,"status_code":86,"description":136,"schema":88,"examples":137,"example":91},"Invalid request, e.g., missing parameters, invalid radius, or radius exceeds limit.",[138],{"name":82,"summary":82,"description":40,"example":91},{"status":93,"status_code":94,"description":95,"schema":88,"examples":140,"example":91},[141],{"name":82,"summary":82,"description":40,"example":91},{"x2":143,"x3":101,"x4":144,"x5":145,"uptime":146,"avg_latency":147,"avg_credits":101},"66.66","33.33","0.01","99.99","871",{"blocked":6,"hidden":6,"agent_price":18,"credits":18,"flexible_credits_description":18,"consumptions":149,"description":151,"method":43,"name":152,"url_path":153,"root_url":46,"parameters":154,"responses":169,"result_stats":183},[150],{"name":37,"slug":38,"cost":39,"label":40,"avg":41},"Retrieves a list of all US zip codes associated with a given city name and a two-letter state abbreviation.","Zip Codes By State & City","/zipcode/v1/by-city",{"url":155,"header":164,"post":166,"body":167,"path":168},[156,160],{"key":157,"example":158,"schema":18,"example_disabled":6,"example_type":52,"value_type":52,"enum_values":18,"default_value":40,"required":17,"name":40,"description":159},"state","IL","The two-letter US state abbreviation (e.g., CA, IL, NY).",{"key":161,"example":162,"schema":18,"example_disabled":6,"example_type":52,"value_type":52,"enum_values":18,"default_value":40,"required":17,"name":40,"description":163},"city","Springfield","The name of the city.",[165],{"key":67,"is_auth":17,"example":68,"example_disabled":17,"example_type":52,"name":69,"description":68,"required":17,"always_error":70},[],[],[],[170,176,180],{"status":76,"status_code":77,"description":171,"schema":172,"examples":173,"example":175},"Successful response with a list of zip codes for the city and state, or empty array if not found.","{\"type\":\"object\",\"description\":\"Successful response wrapper with metadata for city\\/state lookup.\",\"properties\":{\"metadata\":{\"type\":\"object\",\"properties\":{\"timestamp\":{\"type\":\"string\",\"format\":\"date-time\"}},\"required\":[\"timestamp\"]},\"success\":{\"type\":\"boolean\",\"description\":\"Indicates the API call succeeded.\"},\"found\":{\"type\":\"boolean\",\"description\":\"Indicates whether the requested data was found.\"},\"data\":{\"type\":\"object\",\"description\":\"Represents the data structure for a city\\/state to zip codes lookup.\",\"properties\":{\"queriedCity\":{\"type\":\"string\",\"description\":\"The city name that was queried.\"},\"queriedState\":{\"type\":\"string\",\"description\":\"The full state name that was queried.\"},\"queriedStateAbbreviation\":{\"type\":\"string\",\"description\":\"The two-letter state abbreviation that was queried.\"},\"zipcodes\":{\"type\":\"array\",\"description\":\"A list of zip codes found within the queried city and state.\",\"items\":{\"type\":\"object\",\"description\":\"Represents a specific zip code within a city context.\",\"properties\":{\"city\":{\"type\":\"string\",\"description\":\"The name of the city associated with this zip code entry. Note that for a given query, this will typically be the same as queriedCity but is included for structural consistency if a zip code can span multiple \\\"place names\\\" that roll up to a single queried city.\"},\"zipcode\":{\"type\":\"string\",\"description\":\"The zip code identifier.\"}},\"required\":[\"city\",\"zipcode\"]}}},\"required\":[\"queriedCity\",\"queriedState\",\"queriedStateAbbreviation\",\"zipcodes\"]}},\"required\":[\"metadata\",\"success\",\"found\",\"data\"]}",[174],{"name":82,"summary":82,"description":40,"example":175},"{\"metadata\":{\"timestamp\":\"\"},\"success\":true,\"found\":true,\"data\":{\"queriedCity\":\"Springfield\",\"queriedState\":\"Illinois\",\"queriedStateAbbreviation\":\"IL\",\"zipcodes\":[{\"city\":\"Springfield\",\"zipcode\":\"62701\"}]}}",{"status":85,"status_code":86,"description":177,"schema":88,"examples":178,"example":91},"Invalid request, e.g., missing city or state, or invalid state format.",[179],{"name":82,"summary":82,"description":40,"example":91},{"status":93,"status_code":94,"description":95,"schema":88,"examples":181,"example":91},[182],{"name":82,"summary":82,"description":40,"example":91},{"x2":102,"x3":101,"x4":101,"x5":101,"uptime":102,"avg_latency":184,"avg_credits":101},"285",{"blocked":6,"hidden":6,"agent_price":18,"credits":18,"flexible_credits_description":18,"consumptions":186,"description":188,"method":43,"name":189,"url_path":190,"root_url":46,"parameters":191,"responses":202,"result_stats":216},[187],{"name":37,"slug":38,"cost":39,"label":40,"avg":41},"Provides a list of US zip code suggestions based on a partial query string. Useful for implementing type-ahead features.","Autocomplete Suggestions (City and Zip Code)","/zipcode/v1/autocomplete",{"url":192,"header":197,"post":199,"body":200,"path":201},[193],{"key":194,"example":195,"schema":18,"example_disabled":6,"example_type":52,"value_type":52,"enum_values":18,"default_value":40,"required":17,"name":40,"description":196},"q","902","The partial query string for zip code or city name. Minimum 2 characters.",[198],{"key":67,"is_auth":17,"example":68,"example_disabled":17,"example_type":52,"name":69,"description":68,"required":17,"always_error":70},[],[],[],[203,209,213],{"status":76,"status_code":77,"description":204,"schema":205,"examples":206,"example":208},"Successful response with a list of suggestions (can be empty if no matches).","{\"type\":\"object\",\"description\":\"Successful response wrapper with metadata for autocomplete suggestions.\",\"properties\":{\"metadata\":{\"type\":\"object\",\"properties\":{\"timestamp\":{\"type\":\"string\",\"format\":\"date-time\"}},\"required\":[\"timestamp\"]},\"success\":{\"type\":\"boolean\",\"description\":\"Indicates the API call succeeded.\"},\"found\":{\"type\":\"boolean\",\"description\":\"Indicates whether suggestions were found.\"},\"data\":{\"type\":\"object\",\"description\":\"Represents the response for a zip code autocomplete query.\",\"properties\":{\"suggestions\":{\"type\":\"array\",\"description\":\"A list of zip code suggestions based on the query.\",\"items\":{\"type\":\"object\",\"description\":\"Represents a single zip code suggestion for autocomplete.\",\"properties\":{\"zipcode\":{\"type\":\"string\",\"description\":\"The suggested zip code.\"},\"city\":{\"type\":\"string\",\"description\":\"The city associated with the suggested zip code.\"},\"state\":{\"type\":\"string\",\"description\":\"The full state name for the suggestion.\"},\"stateAbbreviation\":{\"type\":\"string\",\"description\":\"The two-letter state abbreviation for the suggestion.\"}},\"required\":[\"zipcode\",\"city\",\"state\",\"stateAbbreviation\"]}}},\"required\":[\"suggestions\"]}},\"required\":[\"metadata\",\"success\",\"found\",\"data\"]}",[207],{"name":82,"summary":82,"description":40,"example":208},"{\"metadata\":{\"timestamp\":\"\"},\"success\":true,\"found\":true,\"data\":{\"suggestions\":[{\"zipcode\":\"90210\",\"city\":\"Beverly Hills\",\"state\":\"California\",\"stateAbbreviation\":\"CA\"}]}}",{"status":85,"status_code":86,"description":210,"schema":88,"examples":211,"example":91},"Invalid request, e.g., missing query parameter or query too short.",[212],{"name":82,"summary":82,"description":40,"example":91},{"status":93,"status_code":94,"description":95,"schema":88,"examples":214,"example":91},[215],{"name":82,"summary":82,"description":40,"example":91},{"x2":102,"x3":101,"x4":101,"x5":101,"uptime":102,"avg_latency":217,"avg_credits":101},"626",{"blocked":6,"hidden":6,"agent_price":18,"credits":18,"flexible_credits_description":18,"consumptions":219,"description":221,"method":43,"name":222,"url_path":223,"root_url":46,"parameters":224,"responses":234,"result_stats":248},[220],{"name":37,"slug":38,"cost":39,"label":40,"avg":41},"Retrieves city and state information associated with a given US zip code.","US Zip Code Info","/zipcode/v1/lookup/{zip}",{"url":225,"header":226,"post":228,"body":229,"path":230},[],[227],{"key":67,"is_auth":17,"example":68,"example_disabled":17,"example_type":52,"name":69,"description":68,"required":17,"always_error":70},[],[],[231],{"key":232,"example":233,"example_disabled":6,"example_type":52,"value_type":52,"enum_values":18,"name":40,"description":40,"required":17},"zip","90102",[235,241,245],{"status":76,"status_code":77,"description":236,"schema":237,"examples":238,"example":240},"Successful response with zip code information, or empty result if not found.","{\"type\":\"object\",\"description\":\"Successful response wrapper with metadata for zip code lookup.\",\"properties\":{\"metadata\":{\"type\":\"object\",\"properties\":{\"timestamp\":{\"type\":\"string\",\"format\":\"date-time\"}},\"required\":[\"timestamp\"]},\"success\":{\"type\":\"boolean\",\"description\":\"Indicates the API call succeeded.\"},\"found\":{\"type\":\"boolean\",\"description\":\"Indicates whether the requested data was found.\"},\"data\":{\"type\":\"object\",\"description\":\"Represents the US-specific data structure for a zip code lookup.\",\"properties\":{\"zipcode\":{\"type\":\"string\",\"description\":\"The requested zip code.\"},\"cities\":{\"type\":\"array\",\"description\":\"A list of cities and their state information associated with the zip code.\",\"items\":{\"type\":\"object\",\"description\":\"Represents US-specific place details.\",\"properties\":{\"city\":{\"type\":\"string\",\"description\":\"The name of the city.\"},\"state\":{\"type\":\"string\",\"description\":\"The full name of the state.\"},\"stateAbbreviation\":{\"type\":\"string\",\"description\":\"The two-letter abbreviation for the state.\"}},\"required\":[\"city\",\"state\",\"stateAbbreviation\"]}}},\"required\":[\"zipcode\",\"cities\"]}},\"required\":[\"metadata\",\"success\",\"found\",\"data\"]}",[239],{"name":82,"summary":82,"description":40,"example":240},"{\"metadata\":{\"timestamp\":\"\"},\"success\":true,\"found\":true,\"data\":{\"zipcode\":\"90210\",\"cities\":[{\"city\":\"Beverly Hills\",\"state\":\"California\",\"stateAbbreviation\":\"CA\"}]}}",{"status":85,"status_code":86,"description":242,"schema":88,"examples":243,"example":91},"Invalid request, e.g., missing zip code.",[244],{"name":82,"summary":82,"description":40,"example":91},{"status":93,"status_code":94,"description":95,"schema":88,"examples":246,"example":91},[247],{"name":82,"summary":82,"description":40,"example":91},{"x2":249,"x3":250,"x4":101,"x5":145,"uptime":146,"avg_latency":251,"avg_credits":101},"42.85","57.14","1,086","US Zip Code Radius & Lookup API",[254,257],{"question":255,"answer":256},"Where does the ZIP code data come from, and how often is it updated?","The data comes from official USPS Postal Bulletins. The database holds 43,623 active ZIP codes with city, state and coordinates. Each new bulletin is processed within 7 days of publication, which covers new ZIP codes, boundary realignments, city name changes and post office closures.",{"question":258,"answer":259},"What does a response with \"found\": false mean?","A miss is not an error. The request was valid and no record matched, so the response is HTTP 200 with \"success\": true and \"found\": false. Reserve error handling for 4xx and 5xx codes, and treat \"found\" as the data question. All timings are reported in the X-Response-Time and Server-Timing headers.",[261],{"id":262,"name":263,"description":264},"n009ae2b4","Radius Lookup Limit","Limit applied on /zipcode/v1/radius",[266,281,291,301],{"type":267,"slug":268,"blocked":6,"period":269,"currency":270,"pricing":271,"rate_limit":275,"objects":276,"name":279,"display_name":279,"features":280},"periodic","3lmabmz38pbt1d54sk3bq0ja","1 MONTH","usd",{"price":272,"credits":272,"past_due_timeout_num":273,"past_due_timeout_type":274},0,3,"DAY",{"max_requests":18,"time_window":18},[277],{"id":278,"name":37,"slug":38,"quota":94,"tiers":18},"n4f1e9ca3","BASIC",[262],{"type":267,"slug":282,"blocked":6,"period":269,"currency":270,"pricing":283,"rate_limit":285,"objects":286,"name":289,"display_name":289,"features":290},"48v6ms923t70ftpdivdwpcha",{"price":284,"credits":272,"past_due_timeout_num":273,"past_due_timeout_type":274},9.99,{"max_requests":18,"time_window":18},[287],{"id":278,"name":37,"slug":38,"quota":288,"tiers":18},25000,"PRO",[262],{"type":267,"slug":292,"blocked":6,"period":269,"currency":270,"pricing":293,"rate_limit":295,"objects":296,"name":299,"display_name":299,"features":300},"7t0ma7c892oz7qvz4ztfvpyb",{"price":294,"credits":272,"past_due_timeout_num":273,"past_due_timeout_type":274},24.99,{"max_requests":18,"time_window":18},[297],{"id":278,"name":37,"slug":38,"quota":298,"tiers":18},100000,"ULTRA",[262],{"type":267,"slug":302,"blocked":6,"period":269,"currency":270,"pricing":303,"rate_limit":305,"objects":306,"name":309,"display_name":309,"features":310},"w80iczpz1srlklg5cng15l2g",{"price":304,"credits":272,"past_due_timeout_num":273,"past_due_timeout_type":274},79.99,{"max_requests":18,"time_window":18},[307],{"id":278,"name":37,"slug":38,"quota":308,"tiers":18},500000,"MEGA",[262],[],{"canonical":313,"page_title":314,"meta":315},"https://jojapi.com/hub/api/us-zip-code-radius-and-lookup-api","US Zip Code Radius and Lookup API Documentation & Playground - JoJ API",{"description":7,"keywords":316},"API,API Documentation,API Playground,Plans & Pricing,US Zip Code Radius and Lookup,payloadic"]