Allows you to autocomplete, verify, and standardize addresses in real-time.
It also offers batch verification which allows you to do the same for thousands of addresses per second.
You can access the platform here where you can also bulk verify lists without having to use the API.
\nNote that you can supply JSON data instead of urlencoded data for all endpoints.
\nAlso note that the API key in this documentation is just an example. please create a new key on the dashboard.
\nYou can authorize your HTTP requests by setting the x-api-key HTTP header to your API key.
You can create an API key by accessing the Developers section of the platform. There, you can click \"Create new access key\" and select the type of key you want. For batch verification, you must use a secret key.
\nAll API endpoints (except preview endpoints) documented here have default rate limit of 5 requests per second. Users are encouraged to use the batch endpoint (https://api.postgrid.com/addver/verifications/batch) documented below for processing large number of addresses. For users who would like to increase the rate limit, please feel free to reach out to support@postgrid.com.
\nIn the event that you are verifying millions of addresses, we recommend doing at most 2 concurrent calls with batch sizes of 2000 addresses each. In general, your throughput is limited to 100 addresses per second, so making more concurrent calls will not necessarily speed up the overall process. If you would like to increase your effective throughput, reach out to support@postgrid.com.
\nIf you're looking to install autocomplete and verification on a website, you can access the Developers section of the dashboard, create a public key, and then click on the API key name. This will show you a guide for installing our pre-built integration on your website without having to access the API directly.
\nOtherwise, you can use the endpoints documented below to create a completely custom integration.
\nWe provide a pre-built web-based autocomplete integration in the Developers section of the dashboard. However, if you want to integrate autocomplete manually, here are our recommended steps:
\nUse the GET /completions endpoint and supply partialStreet via the query params
Allow the user to select one of the autocompleted address previews
\nMake a POST /completions?index=N request where N is the index of the address the user selected
If you follow these steps, there will only be 1 lookup made in total (when the user selects the address).
\nThe top-level JSON response has the following structure:
\nThis object is returned from the verification and autocomplete endpoint to describe issues or incomplete aspects of the given address that were either fixed (which the verification endpoint will always attempt to do) or caused verification failure.
\nPostGrid performs USPS delivery point verification (DPV) on US addresses. The relevant fields are returned in the address details starting with usMailingsDpv. Here is a breakdown of the different return codes for those values.
For the usMailingsDpvConfirmationIndicator
For the usMailingsDpvFootnote1
For the usMailingsDpvFootnote2
For the usMailingsDpvFootnote3
For the usMailingsRecordTypeCode
For the usMailingsSuiteLinkReturnCode
You can request additional address details when using the verification endpoints (both batch and single address) by supplying a query parameter includeDetails=true.
The details have the following schema:
\nNote that the details will be returned in a 'details' subobject and only the relevant fields for a given address will be returned. The fields that are empty will not.
\nYou can have the verification and suggestion endpoints return addresses in Proper Case (e.g. 22-20 Bay St) by supplying a query parameter properCase=true.
All of our POST endpoints also provide geolocation information when geocode=true is provided as a query parameter. You can request this feature be enabled by emailing support@postgrid.com. This includes our verification, batch verification, suggestions, and POST /completions endpoint. Note that you must supply country when geocoding to get the result successfully.
If the query parameter is supplied, the response will include a geocodeResult which has the following schema:
This real number value from 0.00 to 1.00 which represents our confidence in the geocodes. Generally speaking, scores larger than 0.8 are quite accurate. Anything below could be a rough match.
One of the following values:
\nrooftop indicating that the exact point was found
point indicating that the exact point was found within a range of addresses
range_interpolation indicating that we used interpolation to generate the result (still fairly accurate)
nearest_rooftop_match indicating we found a nearby rooftop point and used that
intersection indicating we found a street intersection at the point
street_center indicating we used the center of the closest street
place indicating that the point was a city/town/place
state indicating that the point was just a state
This is the data returned from the verification endpoints. The batch verification endpoint returns an array of these. Note that a verified status means that an address is deliverable as-is, corrected indicates we fixed it (errors will explain what we fixed), and failed means we were not able to fix it (errors might explain why).
This is the data returned from the GET completion endpoint (i.e. the preview endpoint). Each element of the returned array follows this schema.
This is the data stored in the address field of the full completion response (see below).
This is the data returned from the POST completions endpoint. Each element of the returned array follows this schema. If you supply an index query parameter to the completions endpoint, it returns an object instead of an array in data.
A name for the uploaded list. This does not affect processing and is only relevant for what is displayed in the dashboard.
\nrequired
Boolean indicating whether you want to perform international (outside of US & Canada) verification.
\noptional
Boolean indicating whether you would like to append geographical location information (longitude, latitude) to your output information.
\noptional
Boolean indicating whether you would like to
\n","type":"text"},{"key":"defaultCountry","value":"US","description":"An ISO 2-letter country code which is used as the fallback in case your file is missing a country code in the country column.
optional
The column name in your CSV file that contains the first line of your addresses. Note that if your entire address is in a single column, then only specify this mapping and set it to your column.
\nrequired
The column name in your CSV file that contains the second line of your address.
\noptional
The column name in your CSV file that contains the cities of your addresses.
\noptional
The column name in your CSV file that contains the provinces/states of your addresses.
\noptional
The column name in your CSV file that contains the postal/zip codes of your addresses.
\noptional
The column name in your CSV file that contains the country code (2 letter ISO country code, e.g. US not \"United States\")
\noptional
The column name in your CSV file that contains the first name of the person who potentially lives at the given address. Note that this is only used when runNCOA is true.
optional
The column name in your CSV file that contains the last name of the person who potentially lives at the given address. Note that this is only used when runNCOA is true.
optional
The CSV file containing your address data.
\nrequired
Note: For verifying batches of addresses in real-time via JSON, please use the \"Batch Verify Addresses\" endpoint.
\nThe bulk verification API allows you to submit CSV files to be processed through our address verification engine. Each file can contain up to 250,000 addresses, and the output lines up with what is returned from our batch verification API.
\nNote that you will be invoiced for every list that processes successfully. You can pre-purchase bulk verification credits from our dashboard to prevent this. However, these cannot be used for geocoded lists, and you must individually pay for every list that you process with those flags.
\nAlso note that in order to access bulk geocoding you must contact support@postgrid.com to enable the feature.
\n","_postman_id":"42e515b9-d94a-4691-a533-3c4ddc00bc6f"},{"name":"Get Lookup Info","id":"3941f8c1-072e-47f4-8906-56295502cf6e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"url":"{{pg-base}}addver","description":"Returns how many lookups you have used so far. Also tells you the free lookup limit.
\nIf you have not subscribed, all lookups past your limit will fail.
\n","urlObject":{"host":["{{pg-base}}addver"],"query":[],"variable":[]}},"response":[{"id":"ff64c52f-7a48-4993-a361-d209e6d35c44","name":"Get Lookup Info","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"url":"{{pg-base}}addver"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 14 Oct 2020 17:52:53 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"103"},{"key":"Connection","value":"keep-alive"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"67-+v07moZre2Q5K3GtcB6aKwpiPoA\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Successfully retrieved addver info.\",\n \"data\": {\n \"used\": 38,\n \"freeLimit\": 500\n }\n}"}],"_postman_id":"3941f8c1-072e-47f4-8906-56295502cf6e"},{"name":"Get Autocomplete Previews","id":"a7c9e3d6-6fb1-4e5f-85da-ab233a264297","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"url":"{{pg-base}}addver/completions?partialStreet=20 Bouchard Ln&provInsteadOfPC=false","description":"Get previews of autocompleted addresses. Pass the same parameters you would into the equivalent POST endpoint and this will produce responses as follows:
{\n \"status\": \"success\",\n \"message\": \"Retrieved verified address completions successfully.\",\n \"data\": [\n {\n \"preview\": {\n \"address\": \"77 BLOOR ST\",\n \"city\": \"CAPREOL\",\n \"pc\": \"P0M\"\n }\n },\n {\n \"preview\": {\n \"address\": \"77 BLOOR ST E\",\n \"city\": \"OSHAWA\",\n \"pc\": \"L1H\"\n }\n },\n // ...any further results\n ]\n}\nNote how the addresses only contain the first line, city, and the first 3 digits of the postal code/ZIP code. This is because this endpoint does not use any lookups. You can use this to present suggestions to users and then call the POST /completions?index=N endpoint once the user selects the Nth result.
You can also supply a provInsteadOfPC=true query parameter which will cause the API to return prov instead of pc, meaning you can show province or state information rather than showing postal codes.
The partially written street address
\n","type":"text/plain"},"key":"partialStreet","value":"20 Bouchard Ln"},{"disabled":true,"description":{"content":"Only return addresses from this city.
\n","type":"text/plain"},"key":"cityFilter","value":null},{"disabled":true,"description":{"content":"Only return addresses within this province/state.
\n","type":"text/plain"},"key":"stateFilter","value":""},{"disabled":true,"description":{"content":"Only return addreses within this postal/zip code.
\n","type":"text/plain"},"key":"pcFilter","value":null},{"disabled":true,"description":{"content":"The country you want to filter the results by
\n","type":"text/plain"},"key":"countryFilter","value":"CA"},{"description":{"content":"If this is true, we will return the prov field instead of the pc field
The partially written address.
\n","type":"text"},{"key":"cityFilter","value":"Toronto","description":"Only return addresses from this city.
\n","type":"text","disabled":true},{"key":"stateFilter","value":"ON","description":"Only return addresses within this province/state.
\n","type":"text"},{"key":"pcFilter","value":"L8P 0C8","description":"Only return addreses within this postal/zip code.
\n","type":"text"},{"key":"countryFilter","value":"","description":"Only return addresses within this country.
\n","type":"text","disabled":true}]},"url":"{{pg-base}}addver/completions","description":"Provide completions for a partially specified address. You can also provide filters to limit completions to a particular region.
\nUses 1 lookup.
\n","urlObject":{"path":["completions"],"host":["{{pg-base}}addver"],"query":[{"disabled":true,"description":{"content":"An optional parameter you can supply if you want to retrieve the completion result at a particular index.
\n","type":"text/plain"},"key":"index","value":"0"}],"variable":[]}},"response":[{"id":"e32ef9e9-6315-4d39-b57b-f2e3711d84d7","name":"Autocomplete an Address","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"partialStreet","value":"20 bay s","description":"The partially written address.","type":"text"},{"key":"cityFilter","value":"Toronto","description":"Filter completions by this city.","type":"text"},{"key":"stateFilter","value":"","description":"Filter completions by this provinces/states.","type":"text","disabled":true},{"key":"pcFilter","value":"","description":"Filter completions by this postal code.","type":"text","disabled":true},{"key":"countryFilter","value":"","description":"Filter completions to this country.","type":"text","disabled":true}]},"url":"{{pg-base}}addver/completions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 14 Oct 2020 17:38:52 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"994"},{"key":"Connection","value":"keep-alive"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"3e2-kvjbvZkECVcOSV/FXEMIW+yzZAI\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Retrieved verified address completions successfully.\",\n \"data\": [\n {\n \"address\": {\n \"address\": \"20 BAY ST\",\n \"city\": \"TORONTO\",\n \"prov\": \"ON\",\n \"pc\": \"M5H 4A6\",\n \"country\": \"CA\"\n },\n \"errors\": {\n \"line1\": [\n \"Missing Value: Suite identifier\"\n ]\n }\n },\n {\n \"address\": {\n \"address\": \"20 BAY ST\",\n \"city\": \"TORONTO\",\n \"prov\": \"ON\",\n \"pc\": \"M5J 2N8\",\n \"country\": \"CA\"\n },\n \"errors\": {\n \"line1\": [\n \"Missing Value: Suite identifier\"\n ]\n }\n },\n {\n \"address\": {\n \"address\": \"20 BAY ST\",\n \"city\": \"TORONTO\",\n \"prov\": \"ON\",\n \"pc\": \"M5J 2N9\",\n \"country\": \"CA\"\n },\n \"errors\": {\n \"line1\": [\n \"Missing Value: Suite identifier\"\n ]\n }\n },\n {\n \"address\": {\n \"address\": \"20 BAY ST\",\n \"city\": \"TORONTO\",\n \"prov\": \"ON\",\n \"pc\": \"M5J 2W3\",\n \"country\": \"CA\"\n },\n \"errors\": {\n \"line1\": [\n \"Missing Value: Suite identifier\"\n ]\n }\n },\n {\n \"address\": {\n \"address\": \"20 BAY ST\",\n \"city\": \"TORONTO\",\n \"prov\": \"ON\",\n \"pc\": \"M5J 2W4\",\n \"country\": \"CA\"\n },\n \"errors\": {\n \"line1\": [\n \"Missing Value: Suite identifier\"\n ]\n }\n },\n {\n \"address\": {\n \"address\": \"20 BAY ST\",\n \"city\": \"TORONTO\",\n \"prov\": \"ON\",\n \"pc\": \"M5R 2A5\",\n \"country\": \"CA\"\n },\n \"errors\": {\n \"line1\": [\n \"Missing Value: Suite identifier\"\n ]\n }\n }\n ]\n}"}],"_postman_id":"ef1764c6-d9e3-4caa-85d0-7694ec334bdb"},{"name":"Verify a Structured Address","id":"04c8f278-04a6-4bcf-9886-58c5fc221160","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"address[recipient]","value":"Milk Bar","description":"The optional firm/recipient name.
\n","type":"text"},{"key":"address[line1]","value":"251 East 13th Street","description":"The first line of your address.
\n","type":"text"},{"key":"address[line2]","value":"","description":"The second line of your address.
\n","type":"text"},{"key":"address[city]","value":"New York","description":"The city of your address.
\n","type":"text"},{"key":"address[provinceOrState]","value":"NY","description":"The province or state of your address.
\n","type":"text"},{"key":"address[postalOrZip]","value":"","description":"The postal code of your address
\n","type":"text"},{"key":"address[urbanization]","value":"","description":"The urbanization of your address.
\n","type":"text"},{"key":"address[country]","value":"us","description":"The country of your address, one of ca or us.
Verify and standardize a single address which is already structured into Line 1, Line 2, City, etc. All parameters except line1 are optional.
If you supply includeDetails=true as a query parameter, we will also populate an additional details field that follows the Address Details schema.
Note that we make use of the recipient parameter, if provided, to further refine the address. For instance, in the example request, we see that Milk Bar is provided as the recipient and we automatically populate the unit information based on that.
Uses 1 lookup.
\n","urlObject":{"path":["verifications"],"host":["{{pg-base}}addver"],"query":[{"key":"includeDetails","value":"true"},{"disabled":true,"key":"properCase","value":"true"},{"disabled":true,"key":"geocode","value":"true"}],"variable":[]}},"response":[{"id":"da5699ac-f138-4473-8988-40080bb04b06","name":"Verify a Structured Address","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"address[line1]","value":"251 E 13th St","description":"The first line of your address.","type":"text"},{"key":"address[line2]","value":"","description":"The second line of your address.","type":"text"},{"key":"address[city]","value":"new york city","description":"The city of your address.","type":"text"},{"key":"address[provinceOrState]","value":"ny","description":"The province or state of your address.","type":"text"},{"key":"address[postalOrZip]","value":"","description":"The postal code of your address","type":"text"},{"key":"address[country]","value":"us","description":"The country of your address, one of `ca` or `us`.","type":"text"},{"key":"address[recipient]","value":"Milk Bar","type":"text"}]},"url":{"raw":"{{pg-base}}addver/verifications?includeDetails=true&geocode=true","host":["{{pg-base}}addver"],"path":["verifications"],"query":[{"key":"includeDetails","value":"true","description":"If this is 'true', we provide additional details about the verified address. See [details](#address-details)."},{"key":"properCase","value":"true","disabled":true},{"key":"geocode","value":"true","description":"If this is 'true', we include geolocation information (latitude, longitude) and metadata."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 10 Nov 2021 21:21:18 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"551"},{"key":"Connection","value":"keep-alive"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-RateLimit-Limit","value":"100"},{"key":"X-RateLimit-Remaining","value":"99"},{"key":"X-RateLimit-Reset","value":"1636579338"},{"key":"ETag","value":"W/\"227-dkjJCPsYEk+xzBToN9LGw6vP+JI\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Address verification processed.\",\n \"data\": {\n \"city\": \"NEW YORK\",\n \"country\": \"us\",\n \"countryName\": \"UNITED STATES\",\n \"details\": {\n \"streetName\": \"13TH\",\n \"streetType\": \"ST\",\n \"streetDirection\": \"E\",\n \"preDirection\": \"E\",\n \"streetNumber\": \"251\",\n \"suiteID\": \"A\",\n \"suiteKey\": \"FRNT\",\n \"county\": \"NEW YORK\"\n },\n \"errors\": {},\n \"firmName\": \"MILK BAR\",\n \"geocodeResult\": {\n \"location\": {\n \"lat\": 40.731862,\n \"lng\": -73.985679\n },\n \"accuracy\": 1,\n \"accuracyType\": \"rooftop\"\n },\n \"line1\": \"251 E 13TH ST FRNT A\",\n \"postalOrZip\": \"10003\",\n \"provinceOrState\": \"NY\",\n \"status\": \"corrected\",\n \"zipPlus4\": \"5646\"\n }\n}"},{"id":"090e3b57-35a9-49e1-b9b6-7057c59dc4a8","name":"Failed Verification Example","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"address[line1]","value":"22-20 bay st","description":"The first line of your address.","type":"text"},{"key":"address[line2]","value":"floor 11","description":"The second line of your address.","type":"text","disabled":true},{"key":"address[city]","value":"toronto","description":"The city of your address.","type":"text","disabled":true},{"key":"address[provinceOrState]","value":"ontario","description":"The province or state of your address.","type":"text","disabled":true},{"key":"address[country]","value":"canada","description":"The country of your address.","type":"text","disabled":true}]},"url":"{{pg-base}}addver/verifications"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 14 Oct 2020 18:09:15 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"169"},{"key":"Connection","value":"keep-alive"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"a9-xJSwnNFrx810jeZcl2gbtoWyIMI\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Address verified successfully.\",\n \"data\": {\n \"line1\": \"22-20 BAY ST\",\n \"status\": \"failed\",\n \"errors\": {\n \"postalOrZip\": [\n \"Missing Value: Postal Code\"\n ]\n }\n }\n}"}],"_postman_id":"04c8f278-04a6-4bcf-9886-58c5fc221160"},{"name":"Verify a Freeform Address","id":"1061f2ea-00ee-4977-99da-a54872de28c2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"address","value":"UNIT 56 1575, SPRINGHILL DRIVE, KAMLOOPS, BC, V2E2N9, CANADA\n","description":"The address you want to verify, written on a single line.
\n","type":"text"}]},"url":"{{pg-base}}addver/verifications?includeDetails=true","description":"Verify, standardize, and correct an address written on a single line. Ensure that you add the ISO 2-letter country code to the end of the line for best results.
\nUses 1 lookup.
\n","urlObject":{"path":["verifications"],"host":["{{pg-base}}addver"],"query":[{"key":"includeDetails","value":"true"}],"variable":[]}},"response":[{"id":"a9db9ce8-3703-473b-820d-1fa48c50b84c","name":"Verify a Freeform Address","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"address","value":"111 Deerwood Rd - Suite 200 San Ramon CA 94583, US","description":"The address you want to verify, written on a single line.","type":"text"}]},"url":{"raw":"{{pg-base}}addver/verifications?includeDetails=true","host":["{{pg-base}}addver"],"path":["verifications"],"query":[{"key":"includeDetails","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 16 Feb 2024 22:19:51 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"content-security-policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"cross-origin-resource-policy","value":"same-origin"},{"key":"origin-agent-cluster","value":"?1"},{"key":"referrer-policy","value":"no-referrer"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-dns-prefetch-control","value":"off"},{"key":"x-download-options","value":"noopen"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"x-xss-protection","value":"0"},{"key":"vary","value":"Origin"},{"key":"access-control-allow-credentials","value":"true"},{"key":"x-ratelimit-limit","value":"5"},{"key":"x-ratelimit-remaining","value":"4"},{"key":"x-ratelimit-reset","value":"1708121993"},{"key":"etag","value":"W/\"2fa-VYZnY87q+T7p0JZXcZK+bjcGXxQ\""},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=P14ydGTV6M%2FhuNWyqXWe3KWdaGpoMV1nOg7fn%2BlDMtwLIEy0Ol%2FzDGhTp6Y2gALMbUZ33vhp9s2cklaXBDEQX63q2LGH%2FFJqX0L7jgb5zF4LYZAvLDs5Hvvve6afcO6KhImn\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"85692cb14fbf07cc-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Address verification processed.\",\n \"data\": {\n \"city\": \"SAN RAMON\",\n \"country\": \"us\",\n \"countryName\": \"UNITED STATES\",\n \"details\": {\n \"streetName\": \"DEERWOOD\",\n \"streetType\": \"RD\",\n \"streetNumber\": \"111\",\n \"suiteID\": \"200\",\n \"suiteKey\": \"STE\",\n \"county\": \"CONTRA COSTA\",\n \"countyNum\": \"13\",\n \"usMailingsCarrierRoute\": \"C027\",\n \"usMailingsDpvConfirmationIndicator\": \"Y\",\n \"usMailingsDpvCrmaIndicator\": \"N\",\n \"usMailingsElotAscDesc\": \"A\",\n \"usMailingsElotSequenceNumber\": \"0028\",\n \"usMailingsRecordTypeCode\": \"H\",\n \"usMailingsSuiteLinkReturnCode\": \"00\",\n \"usPostnetBarcode\": \"/945834445509/\",\n \"residential\": false,\n \"vacant\": false\n },\n \"errors\": {},\n \"line1\": \"111 DEERWOOD RD STE 200\",\n \"postalOrZip\": \"94583\",\n \"provinceOrState\": \"CA\",\n \"provinceOrStateName\": \"CALIFORNIA\",\n \"status\": \"corrected\",\n \"zipPlus4\": \"4445\"\n }\n}"}],"_postman_id":"1061f2ea-00ee-4977-99da-a54872de28c2"},{"name":"Batch Verify Addresses","id":"94520412-5072-4f5a-a2e2-49981b66a347","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n \"addresses\": [\n {\n \"line1\": \"90 Canal St\",\n \"provinceOrState\": \"MA\",\n \"city\": \"Boston\",\n \"postalOrZip\": \"09420\",\n \"country\": \"US\"\n },\n {\n \"line1\": \"20-20 Bay St\",\n \"city\": \"Toronto\",\n \"provinceOrState\": \"ON\",\n \"postalOrZip\": \"M9V 4V1\",\n \"country\": \"CA\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{pg-base}}addver/verifications/batch?includeDetails=true","description":"Verify up to 2000 addresses (both freeform and structured) with a single API call.
\nNote that valid addresses are either strings or objects containing the structured address fields (line1, line2, etc).
If your batch is larger than your free limit and you are not yet subscribed, the entire batch will fail to verify. You can send in a batch no larger than the remaining number of lookups in that case.
\nUses 1 lookup per address provided.
\n","urlObject":{"path":["verifications","batch"],"host":["{{pg-base}}addver"],"query":[{"key":"includeDetails","value":"true"}],"variable":[]}},"response":[{"id":"5836784b-f1ad-4992-b2c6-bc5f40cb5e28","name":"Batch Verify Addresses","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"raw","raw":"{\n \"addresses\": [\n {\n \"line1\": \"145 mulberry st ph d\",\n \"city\": \"new york\",\n \"provinceOrState\": \"new york\",\n \"postalOrZip\": \"10013\",\n \"country\": \"US\"\n },\n {\n \"line1\": \"90 canal st\",\n \"city\": \"boston\",\n \"provinceOrState\": \"ma\",\n \"country\": \"US\"\n },\n \"20 bay st #22 floor 11 toronto on m9v4v1\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{pg-base}}addver/verifications/batch?includeDetails=true","host":["{{pg-base}}addver"],"path":["verifications","batch"],"query":[{"key":"includeDetails","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-RateLimit-Limit","value":"100"},{"key":"X-RateLimit-Remaining","value":"99"},{"key":"Date","value":"Tue, 23 Aug 2022 01:59:45 GMT"},{"key":"X-RateLimit-Reset","value":"1661219987"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"2862"},{"key":"ETag","value":"W/\"b2e-RQuXsu/4WRjDH6KK6DhEEkS4Kg8\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Verified address batch successfully.\",\n \"data\": {\n \"results\": [\n {\n \"verifiedAddress\": {\n \"line1\": \"145 MULBERRY ST PH D\",\n \"city\": \"NEW YORK\",\n \"postalOrZip\": \"10013\",\n \"provinceOrState\": \"NY\",\n \"country\": \"us\",\n \"countryName\": \"UNITED STATES\",\n \"zipPlus4\": \"5230\",\n \"status\": \"corrected\",\n \"errors\": {},\n \"details\": {\n \"streetName\": \"MULBERRY\",\n \"streetType\": \"ST\",\n \"streetNumber\": \"145\",\n \"suiteID\": \"D\",\n \"suiteKey\": \"PH\",\n \"county\": \"NEW YORK\",\n \"countyNum\": \"61\",\n \"usCensusCMSA\": \"408\",\n \"usCensusBlockNumber\": \"5003\",\n \"usCensusTractNumber\": \"0041.00\",\n \"usCensusFIPS\": \"36061\",\n \"usCensusMA\": \"070\",\n \"usCensusMSA\": \"35620\",\n \"usCensusPMSA\": \"35614\",\n \"usAreaCode\": \"212\",\n \"usHasDaylightSavings\": true,\n \"usTimeZone\": \"EST \",\n \"usCongressionalDistrictNumber\": \"07\",\n \"usStateLegislativeLower\": \"065\",\n \"usStateLegislativeUpper\": \"026\",\n \"usMailingsCSKey\": \"V14966\",\n \"usMailingsCarrierRoute\": \"C002\",\n \"usMailingsCheckDigit\": \"2\",\n \"usMailingsDefaultFlag\": false,\n \"usMailingsDeliveryPoint\": \"76\",\n \"usMailingsDpvConfirmationIndicator\": \"Y\",\n \"usMailingsDpvCrmaIndicator\": \"N\",\n \"usMailingsDpvFootnote1\": \"AA\",\n \"usMailingsDpvFootnote2\": \"BB\",\n \"usMailingsElotAscDesc\": \"A\",\n \"usMailingsElotSequenceNumber\": \"0852\",\n \"usMailingsEWSFlag\": false,\n \"usMailingsRecordTypeCode\": \"H\",\n \"usPostnetBarcode\": \"f100135230762f\",\n \"usIntelligentMailBarcodeKey\": \"WF6xt/oofSrWZi6rwhIj4A==\",\n \"residential\": true,\n \"vacant\": false\n }\n }\n },\n {\n \"verifiedAddress\": {\n \"line1\": \"90 CANAL ST\",\n \"city\": \"BOSTON\",\n \"postalOrZip\": \"02114\",\n \"provinceOrState\": \"MA\",\n \"country\": \"us\",\n \"countryName\": \"UNITED STATES\",\n \"zipPlus4\": \"2018\",\n \"status\": \"failed\",\n \"errors\": {\n \"line1\": [\n \"Missing Value: Suite identifier\"\n ]\n },\n \"details\": {\n \"streetName\": \"CANAL\",\n \"streetType\": \"ST\",\n \"streetNumber\": \"90\",\n \"county\": \"SUFFOLK\",\n \"countyNum\": \"25\",\n \"usCensusCMSA\": \"148\",\n \"usCensusBlockNumber\": \"2047\",\n \"usCensusTractNumber\": \"0203.03\",\n \"usCensusFIPS\": \"25025\",\n \"usCensusMA\": \"007\",\n \"usCensusMSA\": \"14460\",\n \"usCensusPMSA\": \"14454\",\n \"usAreaCode\": \"617\",\n \"usHasDaylightSavings\": true,\n \"usTimeZone\": \"EST \",\n \"usCongressionalDistrictNumber\": \"08\",\n \"usStateLegislativeLower\": \"186\",\n \"usStateLegislativeUpper\": \"027\",\n \"usMailingsCSKey\": \"V21508\",\n \"usMailingsCarrierRoute\": \"C016\",\n \"usMailingsCheckDigit\": \"3\",\n \"usMailingsDefaultFlag\": true,\n \"usMailingsDeliveryPoint\": \"99\",\n \"usMailingsDpvConfirmationIndicator\": \"D\",\n \"usMailingsDpvCrmaIndicator\": \"N\",\n \"usMailingsDpvFootnote1\": \"AA\",\n \"usMailingsDpvFootnote2\": \"N1\",\n \"usMailingsElotAscDesc\": \"A\",\n \"usMailingsElotSequenceNumber\": \"0209\",\n \"usMailingsEWSFlag\": false,\n \"usMailingsRecordTypeCode\": \"H\",\n \"usPostnetBarcode\": \"f021142018993f\",\n \"usIntelligentMailBarcodeKey\": \"fX/JgF+0Ge/2OpJj0dmVLw==\",\n \"residential\": false,\n \"vacant\": false\n }\n }\n },\n {\n \"verifiedAddress\": {\n \"line1\": \"22-20 BAY ST FLOOR 11\",\n \"city\": \"TORONTO\",\n \"postalOrZip\": \"M5J 2N8\",\n \"provinceOrState\": \"ON\",\n \"country\": \"ca\",\n \"countryName\": \"CANADA\",\n \"status\": \"corrected\",\n \"errors\": {\n \"postalOrZip\": [\n \"Incorrect Value: Postal Code\"\n ]\n },\n \"details\": {\n \"streetName\": \"BAY\",\n \"streetType\": \"ST\",\n \"streetNumber\": \"20\",\n \"suiteID\": \"22\",\n \"suiteKey\": \"-\"\n }\n }\n }\n ]\n }\n}"}],"_postman_id":"94520412-5072-4f5a-a2e2-49981b66a347"},{"name":"Suggest Addresses","id":"90361258-5526-4dd9-b6e6-faa83758b3c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"address[line1]","value":"145 Mulberry St","description":"The first line of your address.
\n","type":"text"},{"key":"address[line2]","value":"","description":"The second line of your address.
\n","type":"text"},{"key":"address[city]","value":"New York","description":"The city of your address.
\n","type":"text"},{"key":"address[postalOrZip]","value":"","description":"The postal code or ZIP Code of your address.
\n","type":"text","disabled":true},{"key":"address[provinceOrState]","value":"NY","description":"The province or state of your address.
\n","type":"text"},{"key":"address[country]","value":"US","description":"The country of your address (US or Canada).
\n","type":"text"}]},"url":"{{pg-base}}addver/suggestions?includeDetails=true","description":"This endpoint will find addresses similar to the given address. If your address can be verified or corrected, the first element will contain the resulting verified address.
\nIt will also return unit number ranges in line1 of the suggested addresses like 1 ... 500 - 20 BAY ST.
The response returns an array of Verified Addresses without the status field.
Uses 1 lookup.
\n","urlObject":{"path":["suggestions"],"host":["{{pg-base}}addver"],"query":[{"key":"includeDetails","value":"true"}],"variable":[]}},"response":[{"id":"aacb7d82-5708-4d2a-a820-76e3571eb816","name":"Suggest Addresses","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"live_sk_jtsEa3gJbgfEynwvtDXnk6","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"address[line1]","value":"2220 lakeshore blvd","description":"The first line of your address.","type":"text"},{"key":"address[city]","value":"toronto","description":"The city of your address.","type":"text"},{"key":"address[country]","value":"ca","description":"The country of your address (US or Canada).","type":"text"},{"key":"address[provinceOrState]","value":"on","description":"The province or state of your address.","type":"text"},{"key":"address[line2]","value":"","description":"The second line of your address.","type":"text"},{"key":"address[postalOrZip]","value":"","description":"The postal code or ZIP Code of your address.","type":"text","disabled":true}]},"url":{"raw":"{{pg-base}}addver/suggestions?includeDetails=true","host":["{{pg-base}}addver"],"path":["suggestions"],"query":[{"key":"includeDetails","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-RateLimit-Limit","value":"5"},{"key":"X-RateLimit-Remaining","value":"2"},{"key":"Date","value":"Thu, 14 Jan 2021 01:38:57 GMT"},{"key":"X-RateLimit-Reset","value":"1610588369"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"695"},{"key":"ETag","value":"W/\"2b7-rG6yuFkGGVnGGtwAHlkz7hoZHnQ\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Address suggestions retrieved successfully.\",\n \"data\": [\n {\n \"city\": \"TORONTO\",\n \"country\": \"ca\",\n \"details\": {\n \"streetName\": \"LAKE SHORE\",\n \"streetType\": \"BLVD\",\n \"streetDirection\": \"W\",\n \"streetNumber\": \"2220\"\n },\n \"errors\": {\n \"line1\": [\n \"Typo in Value: Street name\",\n \"Missing Value: Street direction\"\n ],\n \"city\": [\n \"Alternate: Municipality\"\n ],\n \"postalOrZip\": [\n \"Missing Value: Postal Code\"\n ]\n },\n \"line1\": \"2220 LAKE SHORE BLVD W\",\n \"postalOrZip\": \"M8V 0E3\",\n \"provinceOrState\": \"ON\"\n },\n {\n \"city\": \"ETOBICOKE\",\n \"country\": \"ca\",\n \"details\": {\n \"streetName\": \"LAKE SHORE\",\n \"streetType\": \"BLVD\",\n \"streetDirection\": \"W\",\n \"streetNumber\": \"2220\"\n },\n \"errors\": {},\n \"line1\": \"2220 LAKE SHORE BLVD W\",\n \"postalOrZip\": \"M8V 0E3\",\n \"provinceOrState\": \"ON\"\n }\n ]\n}"}],"_postman_id":"90361258-5526-4dd9-b6e6-faa83758b3c1"},{"name":"Suggest Addresses Freeform","id":"2ec12543-9e94-4cf8-8743-b0d40b9dd4ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","type":"text","value":"YOUR_API_KEY"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"address","value":"2220 lakeshore blvd toronto on","type":"text"}]},"url":"{{pg-base}}addver/suggestions?includeDetails=true","description":"Same as the normal address suggestion request except this request sends a freeform address instead of a structured one.
\nUses 1 lookup.
\n","urlObject":{"path":["suggestions"],"host":["{{pg-base}}addver"],"query":[{"key":"includeDetails","value":"true"}],"variable":[]}},"response":[],"_postman_id":"2ec12543-9e94-4cf8-8743-b0d40b9dd4ac"},{"name":"Parse an Address","id":"cd929454-227c-4a31-9a0b-7896099e52d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"},{"key":"x-api-key","type":"text","value":"YOUR_API_KEY"}],"body":{"mode":"urlencoded","urlencoded":[{"description":"The address you want to parse on a single line.
\n","key":"address","type":"text","value":"20 bay st toronto, on m9v4v1, canada"}]},"url":"{{pg-base}}addver/parses","description":"Break an address apart into its components.
\nHere are the components we can produce. All are optional and strings.
\n","urlObject":{"path":["parses"],"host":["{{pg-base}}addver"],"query":[],"variable":[]}},"response":[{"id":"a9b3ea30-8f5a-492f-9069-b42718ce1031","name":"Parse an Address","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"},{"key":"x-api-key","value":"live_sk_tbZJCQ7rHEUqcb1xZj4gdo","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"address","value":"20 bay st toronto, on, canada","type":"text"}]},"url":"{{pg-base}}addver/parses"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 09 Jun 2021 19:20:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"134"},{"key":"Connection","value":"keep-alive"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-RateLimit-Limit","value":"100"},{"key":"X-RateLimit-Remaining","value":"99"},{"key":"X-RateLimit-Reset","value":"1623266508"},{"key":"ETag","value":"W/\"86-EOB6ExX5apqdjiVeIyBGzPKYXiU\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Success.\",\n \"data\": {\n \"city\": \"toronto\",\n \"country\": \"canada\",\n \"houseNumber\": \"20\",\n \"road\": \"bay st\",\n \"state\": \"on\"\n }\n}"}],"_postman_id":"cd929454-227c-4a31-9a0b-7896099e52d1"},{"name":"Lookup City/State from Postal or ZIP Code","id":"10bac08c-301f-4441-af95-0042c25b4298","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"postalOrZip","value":"m9v4v1","type":"text"}]},"url":"{{pg-base}}addver/city_states","description":"Finds valid city and state/province combinations for a given postal/zip code. Uses one verification.
\nHere is an explanation of the fields returned for US ZIP Codes:
\nHere are the fields returned for Canadian postal codes:
\n","urlObject":{"path":["city_states"],"host":["{{pg-base}}addver"],"query":[],"variable":[]}},"response":[{"id":"890a54f7-7da9-4ad3-80f3-a45f173cfbdf","name":"Lookup City/State from ZIP Code","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"postalOrZip","value":"10013","type":"text"}]},"url":"{{pg-base}}addver/city_states"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 13 Feb 2023 23:20:36 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-dns-prefetch-control","value":"off"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains"},{"key":"x-download-options","value":"noopen"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"vary","value":"Origin"},{"key":"access-control-allow-credentials","value":"true"},{"key":"x-ratelimit-limit","value":"1"},{"key":"x-ratelimit-remaining","value":"0"},{"key":"x-ratelimit-reset","value":"1676330438"},{"key":"etag","value":"W/\"50e-EztirgcQo3sB+auO08nD/+rfuM0\""},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=Ug6D9gEQ1qnjiERkqpYNWbH4cnuwivX%2B1mORy4ebDCszW%2FiuAUFUQiaRAVoOgixMOnppGCT%2F1d407sVfniInEl6sl9fRgxwYDTZTkeEQApuKHR5ZiLX9et0t%2FPpgGZOd%2B2RX\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"79914ba94aa82369-EWR"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Success.\",\n \"data\": [\n {\n \"city\": \"NEW YORK CITY\",\n \"country\": \"US\",\n \"county\": \"NEW YORK\",\n \"countyFIPS\": \"061\",\n \"mailable\": false,\n \"preferredCity\": \"NEW YORK\",\n \"provinceOrState\": \"NY\",\n \"zipClass\": \"S\"\n },\n {\n \"city\": \"NY CITY\",\n \"country\": \"US\",\n \"county\": \"NEW YORK\",\n \"countyFIPS\": \"061\",\n \"mailable\": false,\n \"preferredCity\": \"NEW YORK\",\n \"provinceOrState\": \"NY\",\n \"zipClass\": \"S\"\n },\n {\n \"city\": \"NEW YORK\",\n \"country\": \"US\",\n \"county\": \"NEW YORK\",\n \"countyFIPS\": \"061\",\n \"mailable\": true,\n \"preferredCity\": \"NEW YORK\",\n \"provinceOrState\": \"NY\",\n \"zipClass\": \"S\"\n },\n {\n \"city\": \"CANAL STREET\",\n \"country\": \"US\",\n \"county\": \"NEW YORK\",\n \"countyFIPS\": \"061\",\n \"mailable\": true,\n \"preferredCity\": \"NEW YORK\",\n \"provinceOrState\": \"NY\",\n \"zipClass\": \"S\"\n },\n {\n \"city\": \"CHINATOWN\",\n \"country\": \"US\",\n \"county\": \"NEW YORK\",\n \"countyFIPS\": \"061\",\n \"mailable\": true,\n \"preferredCity\": \"NEW YORK\",\n \"provinceOrState\": \"NY\",\n \"zipClass\": \"S\"\n },\n {\n \"city\": \"NYC\",\n \"country\": \"US\",\n \"county\": \"NEW YORK\",\n \"countyFIPS\": \"061\",\n \"mailable\": false,\n \"preferredCity\": \"NEW YORK\",\n \"provinceOrState\": \"NY\",\n \"zipClass\": \"S\"\n },\n {\n \"city\": \"MANHATTAN\",\n \"country\": \"US\",\n \"county\": \"NEW YORK\",\n \"countyFIPS\": \"061\",\n \"mailable\": false,\n \"preferredCity\": \"NEW YORK\",\n \"provinceOrState\": \"NY\",\n \"zipClass\": \"S\"\n },\n {\n \"city\": \"NY\",\n \"country\": \"US\",\n \"county\": \"NEW YORK\",\n \"countyFIPS\": \"061\",\n \"mailable\": false,\n \"preferredCity\": \"NEW YORK\",\n \"provinceOrState\": \"NY\",\n \"zipClass\": \"S\"\n }\n ]\n}"},{"id":"481fca93-6ebd-4fc4-b8a4-6179c99edf71","name":"Lookup City/State from Canadian Postal Code","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"postalOrZip","value":"m9v4v1","description":"A postal or ZIP Code.","type":"text"}]},"url":"{{pg-base}}addver/city_states"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 15 Jul 2021 22:55:59 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-RateLimit-Limit","value":"100"},{"key":"X-RateLimit-Remaining","value":"99"},{"key":"X-RateLimit-Reset","value":"1626389820"},{"key":"ETag","value":"W/\"88-U0/ikIBDTFcwwAUnaPwEoRLyAd8\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Success.\",\n \"data\": [\n {\n \"city\": \"ETOBICOKE\",\n \"provinceOrState\": \"ON\"\n },\n {\n \"city\": \"TORONTO\",\n \"provinceOrState\": \"ON\"\n }\n ]\n}"}],"_postman_id":"10bac08c-301f-4441-af95-0042c25b4298"},{"name":"Lookup ZIP Codes From US City/State","id":"ab677809-e3b8-4a8e-90c0-5af5fb1d92d3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"city","value":"new york","type":"text","description":"The city for which you want to retrieve zip codes.\nrequired
The state for which you want to retrieve zip codes.\nrequired
The country code. The only valid value is US at the moment.\nrequired
Finds valid city and state/province combinations for a given postal/zip code. Uses one verification.
\n","urlObject":{"path":["zip_codes"],"host":["{{pg-base}}addver"],"query":[],"variable":[]}},"response":[{"id":"37254b02-c746-4c20-9ade-2ee07384c9dc","name":"Lookup ZIP Codes Given US City/State","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"YOUR_API_KEY","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"city","value":"new york","type":"text"},{"key":"state","value":"NY","type":"text"},{"key":"countryCode","value":"US","type":"text"}]},"url":"{{pg-base}}addver/zip_codes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 23 Aug 2022 00:42:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-dns-prefetch-control","value":"off"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains"},{"key":"x-download-options","value":"noopen"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-ratelimit-limit","value":"100"},{"key":"x-ratelimit-remaining","value":"99"},{"key":"x-ratelimit-reset","value":"1661215357"},{"key":"etag","value":"W/\"4c7-VPos0sRnocgfXFyLiJ0jw9MEpMM\""},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=LTt8DL%2BJcsKfOP0v2OwlUHgFGqWsz6gvJhRdLXRg6kW%2F0pvZKO95Jf%2BLYWoJ8airYymHnYG81e1fMzOzADllKUVnJXVFhKHFKbv4Y019UQWjfmL0xr5NOwFP%2FqXzi7l3kPw6\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"73efcf20d8319ea6-DFW"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Success.\",\n \"data\": {\n \"zipCodes\": [\n \"10001\",\n \"10002\",\n \"10003\",\n \"10004\",\n \"10005\",\n \"10006\",\n \"10007\",\n \"10008\",\n \"10009\",\n \"10010\",\n \"10011\",\n \"10012\",\n \"10013\",\n \"10014\",\n \"10016\",\n \"10017\",\n \"10018\",\n \"10019\",\n \"10020\",\n \"10021\",\n \"10022\",\n \"10023\",\n \"10024\",\n \"10025\",\n \"10026\",\n \"10027\",\n \"10028\",\n \"10029\",\n \"10030\",\n \"10031\",\n \"10032\",\n \"10033\",\n \"10034\",\n \"10035\",\n \"10036\",\n \"10037\",\n \"10038\",\n \"10039\",\n \"10040\",\n \"10041\",\n \"10043\",\n \"10044\",\n \"10045\",\n \"10055\",\n \"10060\",\n \"10065\",\n \"10069\",\n \"10075\",\n \"10080\",\n \"10081\",\n \"10087\",\n \"10090\",\n \"10101\",\n \"10102\",\n \"10103\",\n \"10104\",\n \"10105\",\n \"10106\",\n \"10107\",\n \"10108\",\n \"10109\",\n \"10110\",\n \"10111\",\n \"10112\",\n \"10113\",\n \"10114\",\n \"10115\",\n \"10116\",\n \"10117\",\n \"10118\",\n \"10119\",\n \"10120\",\n \"10121\",\n \"10122\",\n \"10123\",\n \"10124\",\n \"10125\",\n \"10126\",\n \"10128\",\n \"10129\",\n \"10130\",\n \"10131\",\n \"10132\",\n \"10133\",\n \"10138\",\n \"10150\",\n \"10151\",\n \"10152\",\n \"10153\",\n \"10154\",\n \"10155\",\n \"10156\",\n \"10157\",\n \"10158\",\n \"10159\",\n \"10160\",\n \"10162\",\n \"10163\",\n \"10164\",\n \"10165\",\n \"10166\",\n \"10167\",\n \"10168\",\n \"10169\",\n \"10170\",\n \"10171\",\n \"10172\",\n \"10173\",\n \"10174\",\n \"10175\",\n \"10176\",\n \"10177\",\n \"10178\",\n \"10179\",\n \"10185\",\n \"10199\",\n \"10203\",\n \"10211\",\n \"10212\",\n \"10213\",\n \"10242\",\n \"10249\",\n \"10256\",\n \"10258\",\n \"10259\",\n \"10260\",\n \"10261\",\n \"10265\",\n \"10268\",\n \"10269\",\n \"10270\",\n \"10271\",\n \"10272\",\n \"10273\",\n \"10274\",\n \"10275\",\n \"10276\",\n \"10277\",\n \"10278\",\n \"10279\",\n \"10280\",\n \"10281\",\n \"10282\",\n \"10285\",\n \"10286\"\n ]\n }\n}"}],"_postman_id":"ab677809-e3b8-4a8e-90c0-5af5fb1d92d3"}],"event":[{"listen":"prerequest","script":{"id":"af7c3bc3-c428-4974-8385-c8fc9527a748","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"3cdb620b-958c-44d8-8e80-928275620772","type":"text/javascript","exec":[""]}}],"variable":[{"key":"API Key","value":"YOUR_API_KEY"}]}