{ "item": [ { "id": "f137d730-b775-4f98-868a-daa0a2de9dab", "name": "Geocoding", "description": { "content": "Forward geocoding - convert addresses to coordinates", "type": "text/plain" }, "item": [ { "id": "8872b0d4-90d7-4830-b0bc-63fe3ae159db", "name": "Geocode a single address", "request": { "name": "Geocode a single address", "description": { "content": "Convert a single address to latitude/longitude coordinates", "type": "text/plain" }, "url": { "path": [ "geocode" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "q", "value": "1600 Pennsylvania Ave, Washington DC", "description": "(Required) The address to geocode" }, { "disabled": false, "key": "country", "value": "US", "description": "Limit results to a specific country (ISO 3166-1 alpha-2)" }, { "disabled": false, "key": "limit", "value": "1", "description": "Maximum number of results to return (1-5)" }, { "disabled": false, "key": "format", "value": "full", "description": "Response format" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "a4846c55-b9bd-4cc9-9967-549fddbc058e", "name": "Successful geocoding response", "originalRequest": { "url": { "path": [ "geocode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Pennsylvania Ave, Washington DC" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "1" }, { "key": "format", "value": "full" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "disabled": false, "description": "Maximum requests per minute", "key": "X-RateLimit-Limit", "value": "2977" }, { "disabled": false, "description": "Requests remaining in current window", "key": "X-RateLimit-Remaining", "value": "2977" }, { "disabled": false, "description": "Unix timestamp when window resets", "key": "X-RateLimit-Reset", "value": "2977" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"1600 Pennsylvania Ave, Washington DC\",\n \"results\": [\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n },\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1973-04-13T08:29:17.495Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20845852-d7ea-4aef-8b82-e02bc620bac8", "name": "Bad request - invalid parameters", "originalRequest": { "url": { "path": [ "geocode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Pennsylvania Ave, Washington DC" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "1" }, { "key": "format", "value": "full" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0fedf0f1-30e1-4ad8-986d-679fc280afee", "name": "Unauthorized - invalid or missing API key", "originalRequest": { "url": { "path": [ "geocode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Pennsylvania Ave, Washington DC" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "1" }, { "key": "format", "value": "full" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_api_key\",\n \"message\": \"API key is required. Provide it via 'api_key' query parameter or 'Authorization: Bearer ' header.\",\n \"status\": 401\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dbe720f3-9763-44fe-896e-bce0a2eb52e5", "name": "Forbidden - insufficient permissions", "originalRequest": { "url": { "path": [ "geocode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Pennsylvania Ave, Washington DC" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "1" }, { "key": "format", "value": "full" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"insufficient_permissions\",\n \"message\": \"This API key does not have 'forward' geocoding permission.\",\n \"status\": 403\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b6d5726-5700-4783-b6f5-ada780bd7562", "name": "Rate limit exceeded", "originalRequest": { "url": { "path": [ "geocode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Pennsylvania Ave, Washington DC" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "1" }, { "key": "format", "value": "full" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": false, "description": "Seconds until rate limit resets", "key": "Retry-After", "value": "2977" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Rate limit exceeded. Please wait before making more requests.\",\n \"status\": 429,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bcc4ba49-d748-4729-8c18-a0c2f198854f", "name": "Find addresses near a location", "request": { "name": "Find addresses near a location", "description": { "content": "Search for addresses within a radius of a given coordinate", "type": "text/plain" }, "url": { "path": [ "addresses", "nearby" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "lat", "value": "38.8977", "description": "(Required) Latitude of center point" }, { "disabled": false, "key": "lng", "value": "-77.0365", "description": "(Required) Longitude of center point" }, { "disabled": false, "key": "radius", "value": "100", "description": "Search radius in meters (1-5000)" }, { "disabled": false, "key": "limit", "value": "10", "description": "Maximum results (1-50)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "70a68c97-7079-483d-b13e-1a6140b8bad4", "name": "Nearby addresses", "originalRequest": { "url": { "path": [ "addresses", "nearby" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "38.8977" }, { "key": "lng", "value": "-77.0365" }, { "key": "radius", "value": "100" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"results\": [\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\",\n \"distance_m\": 45.2\n },\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\",\n \"distance_m\": 45.2\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1981-05-30T02:16:45.197Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10af7a3b-87a9-430d-905e-8b07ade3ed98", "name": "Bad request", "originalRequest": { "url": { "path": [ "addresses", "nearby" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "38.8977" }, { "key": "lng", "value": "-77.0365" }, { "key": "radius", "value": "100" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "452dc1e9-aac7-4311-b635-59603df21451", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "addresses", "nearby" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "38.8977" }, { "key": "lng", "value": "-77.0365" }, { "key": "radius", "value": "100" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8ab71f51-9190-4f56-96cb-b42f2faebe35", "name": "Get all addresses on a street", "request": { "name": "Get all addresses on a street", "description": { "content": "Retrieve all known addresses on a specific street", "type": "text/plain" }, "url": { "path": [ "addresses", "street" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "street", "value": "Pennsylvania Avenue NW", "description": "(Required) Street name" }, { "disabled": false, "key": "city", "value": "Washington", "description": "City name" }, { "disabled": false, "key": "state", "value": "DC", "description": "State/region" }, { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" }, { "disabled": false, "key": "limit", "value": "50", "description": "Maximum results (1-100)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "b0ddd9bb-a592-4344-9d56-c6335eef62b6", "name": "Street addresses", "originalRequest": { "url": { "path": [ "addresses", "street" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "street", "value": "Pennsylvania Avenue NW" }, { "key": "city", "value": "Washington" }, { "key": "state", "value": "DC" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "50" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": {\n \"street\": \"Pennsylvania Avenue NW\",\n \"city\": \"Washington\"\n },\n \"results\": [\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n },\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n }\n ],\n \"total_count\": 156,\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1947-02-05T10:05:37.961Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "304feb05-f72f-4433-9b50-0d6235d0e240", "name": "Bad request", "originalRequest": { "url": { "path": [ "addresses", "street" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "street", "value": "Pennsylvania Avenue NW" }, { "key": "city", "value": "Washington" }, { "key": "state", "value": "DC" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "50" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "64c3e646-6a81-4b37-8cdc-f2364a9bbbeb", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "addresses", "street" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "street", "value": "Pennsylvania Avenue NW" }, { "key": "city", "value": "Washington" }, { "key": "state", "value": "DC" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "50" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9da80666-1038-40a9-a75e-63a1e61210bb", "name": "Get address database statistics", "request": { "name": "Get address database statistics", "description": { "content": "Retrieve statistics about address coverage by country", "type": "text/plain" }, "url": { "path": [ "addresses", "stats" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2) for country-specific stats" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "88eb2880-8506-45a0-b0b5-efb3569a37fc", "name": "Address statistics", "originalRequest": { "url": { "path": [ "addresses", "stats" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"total_addresses\": 513900000,\n \"countries\": 52,\n \"by_country\": [\n {\n \"country\": \"BR\",\n \"count\": 138023698,\n \"name\": \"Brazil\"\n },\n {\n \"country\": \"BR\",\n \"count\": 138023698,\n \"name\": \"Brazil\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1989-07-31T01:59:20.609Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b87f3f1c-2a77-41f4-9a80-271f8c7818c7", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "addresses", "stats" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0142c4cb-9515-4916-a745-fb004a297505", "name": "Get random addresses", "request": { "name": "Get random addresses", "description": { "content": "Retrieve random sample addresses, useful for testing and demos", "type": "text/plain" }, "url": { "path": [ "addresses", "random" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" }, { "disabled": false, "key": "limit", "value": "10", "description": "Number of random addresses (1-100)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "b6a4fa42-6ac7-4051-bc96-67ed03b0d23d", "name": "Random addresses", "originalRequest": { "url": { "path": [ "addresses", "random" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"results\": [\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n },\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1970-02-22T09:45:45.865Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f8ffe71d-bb10-4036-bd9b-ecfb972ba0a4", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "addresses", "random" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fb7a9373-4d40-4f00-b5ff-8b099aa577f4", "name": "Interpolate address location", "request": { "name": "Interpolate address location", "description": { "content": "Estimate coordinates for an address using range interpolation when exact match unavailable", "type": "text/plain" }, "url": { "path": [ "addresses", "interpolate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "q", "value": "1601 Pennsylvania Ave, Washington DC", "description": "(Required) The address to interpolate" }, { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "c2114226-c541-468e-90c4-42b13a92214f", "name": "Interpolated address", "originalRequest": { "url": { "path": [ "addresses", "interpolate" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1601 Pennsylvania Ave, Washington DC" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"1601 Pennsylvania Ave, Washington DC\",\n \"result\": {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n },\n \"interpolated\": true,\n \"method\": \"range_interpolation\",\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1981-07-13T18:51:28.023Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dcaa54f1-a730-453e-ae2d-808c337cdd02", "name": "Bad request", "originalRequest": { "url": { "path": [ "addresses", "interpolate" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1601 Pennsylvania Ave, Washington DC" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e87e7a69-0027-401c-86bf-ce33437061a6", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "addresses", "interpolate" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1601 Pennsylvania Ave, Washington DC" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c7c1cb9f-86c6-4335-87f4-11bf51f168da", "name": "Find cross street intersection", "request": { "name": "Find cross street intersection", "description": { "content": "Get the coordinates of an intersection between two streets", "type": "text/plain" }, "url": { "path": [ "addresses", "crossstreet" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "street1", "value": "Pennsylvania Avenue NW", "description": "(Required) First street name" }, { "disabled": false, "key": "street2", "value": "17th Street NW", "description": "(Required) Second street name" }, { "disabled": false, "key": "city", "value": "Washington", "description": "City name" }, { "disabled": false, "key": "state", "value": "DC", "description": "State/region" }, { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "e77f00ab-5a21-4e80-9188-6afd4754ab97", "name": "Cross street intersection", "originalRequest": { "url": { "path": [ "addresses", "crossstreet" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "street1", "value": "Pennsylvania Avenue NW" }, { "key": "street2", "value": "17th Street NW" }, { "key": "city", "value": "Washington" }, { "key": "state", "value": "DC" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"street1\": \"Pennsylvania Avenue NW\",\n \"street2\": \"17th Street NW\",\n \"intersection\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"formatted_address\": \"Pennsylvania Avenue NW & 17th Street NW, Washington, DC\",\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1990-04-09T16:37:33.925Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "979392bd-4506-4601-8cb2-c275e9516b1b", "name": "Bad request", "originalRequest": { "url": { "path": [ "addresses", "crossstreet" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "street1", "value": "Pennsylvania Avenue NW" }, { "key": "street2", "value": "17th Street NW" }, { "key": "city", "value": "Washington" }, { "key": "state", "value": "DC" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f6d012c-6983-43e8-9e39-9856ef830106", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "addresses", "crossstreet" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "street1", "value": "Pennsylvania Avenue NW" }, { "key": "street2", "value": "17th Street NW" }, { "key": "city", "value": "Washington" }, { "key": "state", "value": "DC" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "0542d5ea-d5a8-4ded-97fb-cfa600cb1356", "name": "Reverse Geocoding", "description": { "content": "Reverse geocoding - convert coordinates to addresses", "type": "text/plain" }, "item": [ { "id": "5724ef29-8248-4038-af35-ad14bfa03d7a", "name": "Reverse geocode a single coordinate", "request": { "name": "Reverse geocode a single coordinate", "description": { "content": "Convert latitude/longitude coordinates to a human-readable address", "type": "text/plain" }, "url": { "path": [ "reverse" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "lat", "value": "38.8977", "description": "(Required) Latitude" }, { "disabled": false, "key": "lng", "value": "-77.0365", "description": "(Required) Longitude" }, { "disabled": false, "key": "format", "value": "full", "description": "Response format" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "3f01202b-932f-4c9f-86ff-e6e2ddaa3d96", "name": "Successful reverse geocoding response", "originalRequest": { "url": { "path": [ "reverse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "38.8977" }, { "key": "lng", "value": "-77.0365" }, { "key": "format", "value": "full" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"results\": [\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n },\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2021-11-15T01:27:09.793Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1bbc1544-234d-41f7-ac04-740ae6bb60af", "name": "Bad request", "originalRequest": { "url": { "path": [ "reverse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "38.8977" }, { "key": "lng", "value": "-77.0365" }, { "key": "format", "value": "full" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "26bc4134-7739-443c-9d89-2d55132034f4", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "reverse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "38.8977" }, { "key": "lng", "value": "-77.0365" }, { "key": "format", "value": "full" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "cc75183e-a114-4095-a78b-07dadf034cd8", "name": "Address Tools", "description": { "content": "Validate, parse, standardize, and autocomplete addresses", "type": "text/plain" }, "item": [ { "id": "e7d25fbc-253a-4c8b-966a-5e494eea4d94", "name": "Validate a single address", "request": { "name": "Validate a single address", "description": { "content": "Check if an address is valid and deliverable, with detailed validation results", "type": "text/plain" }, "url": { "path": [ "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "q", "value": "1600 Pennsylvania Ave, Washington DC", "description": "(Required) The address to validate" }, { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "52f33871-a317-4cab-be5a-e189560e558d", "name": "Validation result", "originalRequest": { "url": { "path": [ "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Pennsylvania Ave, Washington DC" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"1600 Pennsylvania Ave, Washington DC\",\n \"valid\": true,\n \"deliverable\": true,\n \"corrected_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"validation_details\": {\n \"confidence\": 0.98\n },\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1972-01-31T23:01:23.713Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bd42460f-f6af-4fe0-88df-60ecf9eba096", "name": "Bad request", "originalRequest": { "url": { "path": [ "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Pennsylvania Ave, Washington DC" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b81d07f-5bc9-4ceb-9540-66f7bce1112b", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Pennsylvania Ave, Washington DC" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "28c4da32-3af7-433c-9b85-cb606a16a8bf", "name": "Autocomplete address input", "request": { "name": "Autocomplete address input", "description": { "content": "Get address suggestions as user types, optimized for type-ahead search", "type": "text/plain" }, "url": { "path": [ "autocomplete" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "q", "value": "1600 Penn", "description": "(Required) Partial address input" }, { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" }, { "disabled": false, "key": "limit", "value": "5", "description": "Maximum suggestions to return (1-10)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "57227e8d-4d25-4206-8a4e-1b66563025f6", "name": "Autocomplete suggestions", "originalRequest": { "url": { "path": [ "autocomplete" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Penn" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "5" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"1600 Penn\",\n \"suggestions\": [\n {\n \"text\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"highlight\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n }\n },\n {\n \"text\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"highlight\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n }\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2018-06-16T20:05:38.374Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fc2d03f4-27e1-499e-9a30-f69685d9b99a", "name": "Bad request", "originalRequest": { "url": { "path": [ "autocomplete" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Penn" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "5" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "38e9bd33-568f-4087-b28a-4e68596e515a", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "autocomplete" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Penn" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "5" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ad7a3d35-c4ed-4139-80ad-461399cd8bdf", "name": "Parse address into components", "request": { "name": "Parse address into components", "description": { "content": "Break down a freeform address into structured components (street, city, state, etc.)", "type": "text/plain" }, "url": { "path": [ "parse" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "q", "value": "1600 Pennsylvania Avenue NW, Washington, DC 20500", "description": "(Required) The address to parse" }, { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "1a538da1-a818-49a7-b589-52fb1c28ee8a", "name": "Parsed address components", "originalRequest": { "url": { "path": [ "parse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Pennsylvania Avenue NW, Washington, DC 20500" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"parsed\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"confidence\": 0.95,\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2001-07-22T19:09:20.097Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0bf75e28-1e3a-46f6-b759-4546bb7cfb90", "name": "Bad request", "originalRequest": { "url": { "path": [ "parse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Pennsylvania Avenue NW, Washington, DC 20500" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6fe26a75-e161-4eee-bf70-c1f1ad420fc2", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "parse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 Pennsylvania Avenue NW, Washington, DC 20500" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "61ce096a-8f6a-4f01-a502-2f272a0ccd72", "name": "Standardize address format", "request": { "name": "Standardize address format", "description": { "content": "Convert address to standardized USPS/postal format", "type": "text/plain" }, "url": { "path": [ "standardize" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "q", "value": "1600 penn ave washington dc", "description": "(Required) The address to standardize" }, { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "15b739b2-d4e8-400d-924b-a173897987a5", "name": "Standardized address", "originalRequest": { "url": { "path": [ "standardize" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 penn ave washington dc" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"1600 penn ave washington dc\",\n \"standardized\": \"1600 PENNSYLVANIA AVE NW, WASHINGTON, DC 20500\",\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1967-10-10T09:36:17.404Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ade977e8-1d96-4870-8387-92136c61c49f", "name": "Bad request", "originalRequest": { "url": { "path": [ "standardize" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 penn ave washington dc" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "db127022-b6ba-49a8-a706-253b6bbc675d", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "standardize" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "1600 penn ave washington dc" }, { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5ac335b3-7bd3-4b1c-8073-1cddafc47f54", "name": "Compare two addresses", "request": { "name": "Compare two addresses", "description": { "content": "Check if two addresses refer to the same location", "type": "text/plain" }, "url": { "path": [ "addresses", "compare" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "address1", "value": "1600 Pennsylvania Ave NW, Washington DC", "description": "(Required) First address" }, { "disabled": false, "key": "address2", "value": "1600 Penn Ave, Washington, DC 20500", "description": "(Required) Second address" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "b48981de-79b0-4c01-974a-7e6d3018acb6", "name": "Comparison result", "originalRequest": { "url": { "path": [ "addresses", "compare" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address1", "value": "1600 Pennsylvania Ave NW, Washington DC" }, { "key": "address2", "value": "1600 Penn Ave, Washington, DC 20500" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"address1\": \"1600 Pennsylvania Ave NW, Washington DC\",\n \"address2\": \"1600 Penn Ave, Washington, DC 20500\",\n \"match\": true,\n \"similarity_score\": 0.95,\n \"distance_m\": 0,\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1985-01-16T17:47:57.830Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "46d91477-6f90-44e8-8ebd-143cbbe460db", "name": "Bad request", "originalRequest": { "url": { "path": [ "addresses", "compare" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address1", "value": "1600 Pennsylvania Ave NW, Washington DC" }, { "key": "address2", "value": "1600 Penn Ave, Washington, DC 20500" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "33a70457-8a33-43e7-8a70-4c72bd5007d4", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "addresses", "compare" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address1", "value": "1600 Pennsylvania Ave NW, Washington DC" }, { "key": "address2", "value": "1600 Penn Ave, Washington, DC 20500" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "925a69e2-ca87-45ab-a4f0-91e65210962a", "name": "Batch", "description": { "content": "Batch processing for multiple addresses or coordinates", "type": "text/plain" }, "item": [ { "id": "af9a790a-6555-47b2-987a-8a627da2062f", "name": "Batch geocode multiple addresses", "request": { "name": "Batch geocode multiple addresses", "description": { "content": "Convert up to 10,000 addresses to coordinates in a single request", "type": "text/plain" }, "url": { "path": [ "geocode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"1600 Pennsylvania Ave, Washington DC\",\n \"350 Fifth Avenue, New York, NY\",\n \"1 Infinite Loop, Cupertino, CA\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "19b15920-2dec-42c2-9251-5370dd4e9e48", "name": "Successful batch geocoding response", "originalRequest": { "url": { "path": [ "geocode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"1600 Pennsylvania Ave, Washington DC\",\n \"350 Fifth Avenue, New York, NY\",\n \"1 Infinite Loop, Cupertino, CA\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"results\": [\n {\n \"query\": \"1600 Pennsylvania Ave, Washington DC\",\n \"results\": [\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n },\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1966-08-27T18:48:28.347Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n },\n {\n \"query\": \"1600 Pennsylvania Ave, Washington DC\",\n \"results\": [\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n },\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1957-07-13T03:52:27.007Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1959-03-07T09:21:37.559Z\",\n \"total_addresses\": 3,\n \"successful\": 3,\n \"failed\": 0,\n \"credits_used\": 3,\n \"credits_remaining\": 9997\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9f95e660-5bdb-4a0b-824a-65e5b2d730b2", "name": "Bad request", "originalRequest": { "url": { "path": [ "geocode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"1600 Pennsylvania Ave, Washington DC\",\n \"350 Fifth Avenue, New York, NY\",\n \"1 Infinite Loop, Cupertino, CA\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "96b464e9-0be6-4c05-8a9f-b9298352df12", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "geocode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"1600 Pennsylvania Ave, Washington DC\",\n \"350 Fifth Avenue, New York, NY\",\n \"1 Infinite Loop, Cupertino, CA\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d948b903-5b56-4e3e-bdf3-d7c40ea89e5c", "name": "Batch reverse geocode multiple coordinates", "request": { "name": "Batch reverse geocode multiple coordinates", "description": { "content": "Convert up to 10,000 coordinates to addresses in a single request", "type": "text/plain" }, "url": { "path": [ "reverse" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"coordinates\": [\n {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n {\n \"lat\": 40.7484,\n \"lng\": -73.9857\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "e93c7342-b1fc-4c3d-aefa-4d02ce34cfe4", "name": "Successful batch reverse geocoding response", "originalRequest": { "url": { "path": [ "reverse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"coordinates\": [\n {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n {\n \"lat\": 40.7484,\n \"lng\": -73.9857\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"results\": [\n {\n \"query\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"results\": [\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n },\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2022-09-17T14:05:56.624Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n },\n {\n \"query\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"results\": [\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n },\n {\n \"formatted_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"accuracy\": \"rooftop\",\n \"accuracy_score\": 0.98,\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"source\": \"Overture Maps Foundation\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1949-03-20T18:08:29.656Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1948-12-23T10:37:26.394Z\",\n \"total_addresses\": 3,\n \"successful\": 3,\n \"failed\": 0,\n \"credits_used\": 3,\n \"credits_remaining\": 9997\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4622917b-aeab-429b-bd83-b43abd83486a", "name": "Bad request", "originalRequest": { "url": { "path": [ "reverse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"coordinates\": [\n {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n {\n \"lat\": 40.7484,\n \"lng\": -73.9857\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "289ab6a2-34e7-47d9-a6b2-24b8240a6380", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "reverse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"coordinates\": [\n {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n {\n \"lat\": 40.7484,\n \"lng\": -73.9857\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a2a7ec39-755f-4e70-b144-490df44bcb28", "name": "Batch validate multiple addresses", "request": { "name": "Batch validate multiple addresses", "description": { "content": "Validate up to 10,000 addresses in a single request", "type": "text/plain" }, "url": { "path": [ "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "eec8dae5-736f-4234-b1d2-9e9e16994c14", "name": "Batch validation results", "originalRequest": { "url": { "path": [ "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"results\": [\n {\n \"query\": \"1600 Pennsylvania Ave, Washington DC\",\n \"valid\": true,\n \"deliverable\": true,\n \"corrected_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"validation_details\": {\n \"confidence\": 0.98\n },\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2024-12-31T08:23:49.828Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n },\n {\n \"query\": \"1600 Pennsylvania Ave, Washington DC\",\n \"valid\": true,\n \"deliverable\": true,\n \"corrected_address\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"components\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"validation_details\": {\n \"confidence\": 0.98\n },\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1970-04-18T09:47:23.377Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2010-12-03T20:54:12.387Z\",\n \"total_addresses\": 3,\n \"successful\": 3,\n \"failed\": 0,\n \"credits_used\": 3,\n \"credits_remaining\": 9997\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8dfba841-6f9e-4cf0-a92a-ee7f5e5685af", "name": "Bad request", "originalRequest": { "url": { "path": [ "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f5c6225d-d166-4cc6-8598-8efd93b67fbf", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ba7ad46a-2727-4f1c-822d-32ee0af09999", "name": "Batch parse multiple addresses", "request": { "name": "Batch parse multiple addresses", "description": { "content": "Parse up to 10,000 addresses into components in a single request", "type": "text/plain" }, "url": { "path": [ "parse" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "28600967-ad6c-4293-8b5b-44f538c9abb4", "name": "Batch parse results", "originalRequest": { "url": { "path": [ "parse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"results\": [\n {\n \"query\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"parsed\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"confidence\": 0.95,\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1991-02-25T05:03:46.357Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n },\n {\n \"query\": \"1600 Pennsylvania Avenue NW, Washington, DC 20500\",\n \"parsed\": {\n \"house_number\": \"1600\",\n \"street\": \"Pennsylvania Avenue NW\",\n \"unit\": null,\n \"city\": \"Washington\",\n \"state\": \"DC\",\n \"postcode\": \"20500\",\n \"country\": \"US\"\n },\n \"confidence\": 0.95,\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1976-12-24T12:27:46.282Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1966-09-26T19:26:40.768Z\",\n \"total_addresses\": 3,\n \"successful\": 3,\n \"failed\": 0,\n \"credits_used\": 3,\n \"credits_remaining\": 9997\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec73d20e-23d1-4cea-8c91-29bb69b50bda", "name": "Bad request", "originalRequest": { "url": { "path": [ "parse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fc4bd559-ce57-47e7-a7c5-8d715a6f11f4", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "parse" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"addresses\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f4be3b99-9961-4f6a-8e91-3d64a3375390", "name": "Batch lookup places by ID", "request": { "name": "Batch lookup places by ID", "description": { "content": "Retrieve multiple places by their IDs in a single request", "type": "text/plain" }, "url": { "path": [ "places", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "a60d1fd5-e12f-4c4f-b640-f6f1b09e716e", "name": "Batch places response", "originalRequest": { "url": { "path": [ "places", "batch" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"starbucks\",\n \"results\": [\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n },\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2015-06-12T01:36:22.964Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8d196c56-41f0-42b5-ad15-e6755c4fc6ae", "name": "Bad request", "originalRequest": { "url": { "path": [ "places", "batch" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25168286-48ee-421a-8c80-fb81f65bf78f", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "places", "batch" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"string\",\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "70b319fb-da86-47e2-876f-ebafa33f77c2", "name": "Places", "description": { "content": "Search 72M+ POIs - businesses, landmarks, restaurants, and more", "type": "text/plain" }, "item": [ { "id": "cba708bb-8d85-478c-a11a-90cb41e7539b", "name": "Search places by name", "request": { "name": "Search places by name", "description": { "content": "Search for points of interest (POIs) by name. Returns businesses, landmarks, and other places matching your query.\n\nUses text search to match place names and brand names.\n", "type": "text/plain" }, "url": { "path": [ "places" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "q", "value": "starbucks", "description": "(Required) Search query (place name, brand, etc.)" }, { "disabled": false, "key": "category", "value": "coffee_shop", "description": "Filter by category (e.g., \"coffee_shop\", \"restaurant\")" }, { "disabled": false, "key": "country", "value": "US", "description": "Filter by country (ISO 3166-1 alpha-2). Defaults to \"US\"" }, { "disabled": false, "key": "limit", "value": "10", "description": "Maximum number of results (1-50)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "e7bf0857-0961-4b7e-80f0-1bdf0441f264", "name": "Successful search response", "originalRequest": { "url": { "path": [ "places" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "starbucks" }, { "key": "category", "value": "coffee_shop" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"starbucks\",\n \"results\": [\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n },\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1966-04-23T03:51:01.091Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4355870b-adea-4159-acfd-23e644065e4c", "name": "Bad request - missing query parameter", "originalRequest": { "url": { "path": [ "places" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "starbucks" }, { "key": "category", "value": "coffee_shop" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_query\",\n \"message\": \"The 'q' parameter is required for place search\",\n \"status\": 400\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f93d03c-176b-4517-9fef-9c4fb0504e6e", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "places" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "starbucks" }, { "key": "category", "value": "coffee_shop" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "65b117fd-f8e8-40a4-8ec4-9f94c8ad3ac2", "name": "Find places near a location", "request": { "name": "Find places near a location", "description": { "content": "Search for places within a radius of a given location. Results are sorted by distance from the center point.\n\nUses geospatial indexing for efficient nearby searches.\n", "type": "text/plain" }, "url": { "path": [ "places", "nearby" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "lat", "value": "40.7128", "description": "(Required) Latitude of center point" }, { "disabled": false, "key": "lng", "value": "-74.006", "description": "(Required) Longitude of center point" }, { "disabled": false, "key": "radius", "value": "1000", "description": "Search radius in meters (1-50000). Default is 1000m (1km)" }, { "disabled": false, "key": "category", "value": "restaurant", "description": "Filter by category" }, { "disabled": false, "key": "limit", "value": "10", "description": "Maximum number of results (1-50)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "f97d1168-a45e-4913-889b-41e4d737966a", "name": "Successful nearby search response", "originalRequest": { "url": { "path": [ "places", "nearby" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "40.7128" }, { "key": "lng", "value": "-74.006" }, { "key": "radius", "value": "1000" }, { "key": "category", "value": "restaurant" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": {\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"radius\": 1000,\n \"category\": \"restaurant\"\n },\n \"results\": [\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n },\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1992-10-11T16:48:07.968Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "96b890a3-08fc-4c32-b683-4378416b751d", "name": "Bad request - invalid coordinates or parameters", "originalRequest": { "url": { "path": [ "places", "nearby" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "40.7128" }, { "key": "lng", "value": "-74.006" }, { "key": "radius", "value": "1000" }, { "key": "category", "value": "restaurant" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_coordinates\",\n \"message\": \"Both 'lat' and 'lng' parameters are required\",\n \"status\": 400\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "218aea36-cb99-4929-a18d-fbb7be06672b", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "places", "nearby" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "40.7128" }, { "key": "lng", "value": "-74.006" }, { "key": "radius", "value": "1000" }, { "key": "category", "value": "restaurant" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2e5c6028-2182-464c-b53b-fbf9ebb384d5", "name": "List available place categories", "request": { "name": "List available place categories", "description": { "content": "Returns all available place categories in the database. Use these values to filter searches by category.\n", "type": "text/plain" }, "url": { "path": [ "places", "categories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "6895db55-5b0c-4964-aac6-fca22e628f95", "name": "List of categories", "originalRequest": { "url": { "path": [ "places", "categories" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"categories\": [\n \"coffee_shop\",\n \"restaurant\",\n \"hotel\",\n \"gas_station\",\n \"pharmacy\"\n ],\n \"count\": 150,\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2002-02-26T10:27:48.969Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a8ffcc46-1d22-4af4-bb00-89760adf7adc", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "places", "categories" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5b0de5d6-25e3-479d-a26b-8e7e0c8ebd42", "name": "Get random places", "request": { "name": "Get random places", "description": { "content": "Retrieve random sample places, useful for testing and demos", "type": "text/plain" }, "url": { "path": [ "places", "random" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "category", "value": "restaurant", "description": "Filter by category" }, { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" }, { "disabled": false, "key": "limit", "value": "10", "description": "Number of random places (1-100)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "b403059e-5f09-4c5d-9438-e5196faaa006", "name": "Random places", "originalRequest": { "url": { "path": [ "places", "random" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "category", "value": "restaurant" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"starbucks\",\n \"results\": [\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n },\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2015-06-12T01:36:22.964Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9c4162a3-c66b-485b-86d5-9329d5ae5394", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "places", "random" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "category", "value": "restaurant" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8818e3c2-bc54-4707-ae61-58485fd2985b", "name": "Get places database statistics", "request": { "name": "Get places database statistics", "description": { "content": "Retrieve statistics about place coverage by country and category", "type": "text/plain" }, "url": { "path": [ "places", "stats" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2) for country-specific stats" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "27ad455d-4892-4c7e-9b5b-32f2da0bd0ef", "name": "Places statistics", "originalRequest": { "url": { "path": [ "places", "stats" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"total_places\": 72400000,\n \"countries\": 52,\n \"categories\": 150,\n \"top_categories\": [\n {\n \"category\": \"restaurant\",\n \"count\": 2000000\n },\n {\n \"category\": \"restaurant\",\n \"count\": 2000000\n }\n ],\n \"by_country\": [\n {\n \"country\": \"US\",\n \"count\": 15500000,\n \"name\": \"United States\"\n },\n {\n \"country\": \"US\",\n \"count\": 15500000,\n \"name\": \"United States\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1979-11-21T08:26:39.854Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a74122f6-fb7d-4a72-bc2d-42af446ad3c5", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "places", "stats" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c19a0f61-1929-49c3-9973-3149e0e77bb9", "name": "List available brands", "request": { "name": "List available brands", "description": { "content": "Get a list of all brand names in the database with place counts", "type": "text/plain" }, "url": { "path": [ "places", "brands" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" }, { "disabled": false, "key": "limit", "value": "100", "description": "Maximum brands to return (1-500)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "ffd2f19b-752f-4f20-902e-6de61a55b798", "name": "List of brands", "originalRequest": { "url": { "path": [ "places", "brands" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country", "value": "US" }, { "key": "limit", "value": "100" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"brands\": [\n {\n \"name\": \"Starbucks\",\n \"count\": 35000\n },\n {\n \"name\": \"Starbucks\",\n \"count\": 35000\n }\n ],\n \"total_count\": 15000,\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2000-10-19T20:34:52.807Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f890663-2724-471c-a9e0-d9bf46a47a3f", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "places", "brands" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country", "value": "US" }, { "key": "limit", "value": "100" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "54c0e2c3-9f2e-4f6a-a8da-593b2e4d3a20", "name": "Get all locations of a chain/brand", "request": { "name": "Get all locations of a chain/brand", "description": { "content": "Find all locations of a specific brand or chain (e.g., all Starbucks)", "type": "text/plain" }, "url": { "path": [ "places", "chain" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "brand", "value": "Starbucks", "description": "(Required) Brand name" }, { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" }, { "disabled": false, "key": "state", "value": "CA", "description": "State/region filter" }, { "disabled": false, "key": "limit", "value": "100", "description": "Maximum results (1-1000)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "74e591bb-d1d5-4ce3-bdc3-13dfc1999f92", "name": "Chain locations", "originalRequest": { "url": { "path": [ "places", "chain" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "brand", "value": "Starbucks" }, { "key": "country", "value": "US" }, { "key": "state", "value": "CA" }, { "key": "limit", "value": "100" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"starbucks\",\n \"results\": [\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n },\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2015-06-12T01:36:22.964Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a98e0734-d655-4872-89aa-ac496193c626", "name": "Bad request", "originalRequest": { "url": { "path": [ "places", "chain" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "brand", "value": "Starbucks" }, { "key": "country", "value": "US" }, { "key": "state", "value": "CA" }, { "key": "limit", "value": "100" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad6e2e5a-ec0b-4df0-9cc5-033cdf588ab1", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "places", "chain" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "brand", "value": "Starbucks" }, { "key": "country", "value": "US" }, { "key": "state", "value": "CA" }, { "key": "limit", "value": "100" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a5941a77-7dbd-405d-be57-c570a21cc326", "name": "Count places matching criteria", "request": { "name": "Count places matching criteria", "description": { "content": "Get count of places matching search criteria without returning full results", "type": "text/plain" }, "url": { "path": [ "places", "count" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "category", "value": "coffee_shop", "description": "Filter by category" }, { "disabled": false, "key": "brand", "value": "Starbucks", "description": "Filter by brand" }, { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" }, { "disabled": false, "key": "state", "value": "CA", "description": "State/region filter" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "f40f1dcf-9264-496c-8a0e-c3f65878a09b", "name": "Place count", "originalRequest": { "url": { "path": [ "places", "count" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "category", "value": "coffee_shop" }, { "key": "brand", "value": "Starbucks" }, { "key": "country", "value": "US" }, { "key": "state", "value": "CA" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"count\": 35000,\n \"filters\": {\n \"category\": \"string\",\n \"brand\": \"string\",\n \"country\": \"string\",\n \"state\": \"string\"\n },\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1996-03-17T21:29:22.385Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1d12264c-2b17-466b-88bf-f5d08deb0e5e", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "places", "count" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "category", "value": "coffee_shop" }, { "key": "brand", "value": "Starbucks" }, { "key": "country", "value": "US" }, { "key": "state", "value": "CA" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4d352028-0bf4-45d9-a27d-1a9e511816f8", "name": "Find similar places", "request": { "name": "Find similar places", "description": { "content": "Find places similar to a given place by category, location, or attributes", "type": "text/plain" }, "url": { "path": [ "places", "similar" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "id", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "description": "(Required) Place ID to find similar places for" }, { "disabled": false, "key": "radius", "value": "5000", "description": "Search radius in meters (1-50000)" }, { "disabled": false, "key": "limit", "value": "10", "description": "Maximum results (1-50)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "dee4877c-65cb-4f80-a540-98db6d405b4f", "name": "Similar places", "originalRequest": { "url": { "path": [ "places", "similar" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "id", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6" }, { "key": "radius", "value": "5000" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"starbucks\",\n \"results\": [\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n },\n {\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\",\n \"food_and_drink\"\n ],\n \"confidence\": 0.95,\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2015-06-12T01:36:22.964Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41c6eb26-97ff-40f1-a5a9-1cf5b087d23f", "name": "Bad request", "originalRequest": { "url": { "path": [ "places", "similar" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "id", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6" }, { "key": "radius", "value": "5000" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "32fba2a9-0a68-4049-abf9-fba4631e4fcd", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "places", "similar" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "id", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6" }, { "key": "radius", "value": "5000" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a952029a-0440-47d2-848b-3832557f73a4", "name": "Get place by ID", "request": { "name": "Get place by ID", "description": { "content": "Retrieve detailed information about a specific place", "type": "text/plain" }, "url": { "path": [ "places", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Place ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "72a9a517-a55a-4154-9d28-8d087ed1b7df", "name": "Place details", "originalRequest": { "url": { "path": [ "places", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Place ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"08f28a8f-8c8b-4896-815e-c92c8df0a8a6\",\n \"name\": \"Starbucks\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"category\": \"coffee_shop\",\n \"categories\": [\n \"coffee_shop\",\n \"cafe\"\n ],\n \"address\": \"123 Main St, New York, NY 10001\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"postcode\": \"10001\",\n \"country\": \"US\",\n \"phone\": \"+1-555-123-4567\",\n \"website\": \"https://www.starbucks.com\",\n \"brand\": \"Starbucks\",\n \"operating_status\": \"open\",\n \"confidence\": 0.95,\n \"source\": \"Overture Maps Foundation\",\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1985-09-06T17:16:11.382Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff56f7a5-29be-449b-b841-36648480f7fe", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "places", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Place ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df012f5f-4f88-45ac-883b-9bff0250fd4a", "name": "Place not found", "originalRequest": { "url": { "path": [ "places", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Place ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "16ee809f-c4ae-4414-925c-85d1e3a253b1", "name": "Divisions", "description": { "content": "4.6M+ administrative boundaries - cities, counties, neighborhoods, states", "type": "text/plain" }, "item": [ { "id": "1eca7eba-006d-48b2-9f23-8c28f52c4f7a", "name": "Search divisions by name", "request": { "name": "Search divisions by name", "description": { "content": "Search for administrative divisions (cities, counties, neighborhoods) by name.\nUses text search to match division names.\n", "type": "text/plain" }, "url": { "path": [ "divisions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "q", "value": "los angeles", "description": "(Required) Search query (division name)" }, { "disabled": false, "key": "subtype", "value": "locality", "description": "Filter by division type (locality, county, neighborhood, etc.)" }, { "disabled": false, "key": "country", "value": "US", "description": "Filter by country (ISO 3166-1 alpha-2). Defaults to \"US\"" }, { "disabled": false, "key": "limit", "value": "10", "description": "Maximum number of results (1-50)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "cdd8baf8-b8ab-44c4-b13d-661fa8d8a529", "name": "Successful search response", "originalRequest": { "url": { "path": [ "divisions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "los angeles" }, { "key": "subtype", "value": "locality" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"los angeles\",\n \"results\": [\n {\n \"name\": \"Los Angeles\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"subtype\": \"locality\",\n \"country\": \"US\",\n \"region\": \"US-CA\",\n \"population\": 4030904,\n \"wikidata\": \"Q65\",\n \"parent_division_id\": \"9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb\"\n },\n {\n \"name\": \"Los Angeles\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"subtype\": \"locality\",\n \"country\": \"US\",\n \"region\": \"US-CA\",\n \"population\": 4030904,\n \"wikidata\": \"Q65\",\n \"parent_division_id\": \"9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2002-03-31T02:59:57.208Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f93d7651-b8ae-4c7e-8b45-4d65bf57b79f", "name": "Bad request - missing query parameter", "originalRequest": { "url": { "path": [ "divisions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "los angeles" }, { "key": "subtype", "value": "locality" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_query\",\n \"message\": \"The 'q' parameter is required for division search\",\n \"status\": 400\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c9565e67-c291-4c90-867a-2f531a00034d", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "divisions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "q", "value": "los angeles" }, { "key": "subtype", "value": "locality" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "095c3eed-cdfb-4c26-9200-d1c4f25dc423", "name": "Find divisions near a location", "request": { "name": "Find divisions near a location", "description": { "content": "Find administrative divisions near a given coordinate. Returns divisions sorted by distance.\nUseful for answering \"What city/county/neighborhood is this location in?\"\n", "type": "text/plain" }, "url": { "path": [ "divisions", "contains" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "lat", "value": "40.7128", "description": "(Required) Latitude of the point" }, { "disabled": false, "key": "lng", "value": "-74.006", "description": "(Required) Longitude of the point" }, { "disabled": false, "key": "subtype", "value": "locality", "description": "Filter by division type" }, { "disabled": false, "key": "limit", "value": "10", "description": "Maximum number of results (1-50)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "97200dfc-e05c-462b-bb5c-af3fd3a4299f", "name": "Successful lookup response", "originalRequest": { "url": { "path": [ "divisions", "contains" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "40.7128" }, { "key": "lng", "value": "-74.006" }, { "key": "subtype", "value": "locality" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"results\": [\n {\n \"name\": \"Los Angeles\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"subtype\": \"locality\",\n \"country\": \"US\",\n \"region\": \"US-CA\",\n \"population\": 4030904,\n \"wikidata\": \"Q65\",\n \"parent_division_id\": \"9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb\"\n },\n {\n \"name\": \"Los Angeles\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"subtype\": \"locality\",\n \"country\": \"US\",\n \"region\": \"US-CA\",\n \"population\": 4030904,\n \"wikidata\": \"Q65\",\n \"parent_division_id\": \"9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2020-01-06T09:46:02.809Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6294ee4e-e7bb-4802-a11f-b144a46fbaea", "name": "Bad request - invalid coordinates", "originalRequest": { "url": { "path": [ "divisions", "contains" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "40.7128" }, { "key": "lng", "value": "-74.006" }, { "key": "subtype", "value": "locality" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_coordinates\",\n \"message\": \"Both 'lat' and 'lng' parameters are required\",\n \"status\": 400\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f4ff044d-6628-4cb5-8384-6e7cd800ce26", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "divisions", "contains" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "40.7128" }, { "key": "lng", "value": "-74.006" }, { "key": "subtype", "value": "locality" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "968b59e7-60ed-4347-8a0e-acc67cd5264f", "name": "List available division subtypes", "request": { "name": "List available division subtypes", "description": { "content": "Returns all available division subtypes (e.g., country, region, county, locality, neighborhood).\nUse these values to filter searches by subtype.\n", "type": "text/plain" }, "url": { "path": [ "divisions", "subtypes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "1f59b919-f147-4552-bcfb-a40bc6b729c3", "name": "List of subtypes", "originalRequest": { "url": { "path": [ "divisions", "subtypes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"subtypes\": [\n \"country\",\n \"region\",\n \"county\",\n \"locality\",\n \"neighborhood\",\n \"macrohood\",\n \"microhood\"\n ],\n \"count\": 7,\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2023-03-01T12:07:07.865Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b80a4f6e-9e04-4191-b004-b333a0f79d24", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "divisions", "subtypes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4713236d-4c15-4151-ba51-fc41fe50d209", "name": "List countries with coverage", "request": { "name": "List countries with coverage", "description": { "content": "Get list of all countries in the database with division counts", "type": "text/plain" }, "url": { "path": [ "divisions", "countries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "56b87d7b-85ad-43b1-a429-6d9a0997cd27", "name": "List of countries", "originalRequest": { "url": { "path": [ "divisions", "countries" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"countries\": [\n {\n \"code\": \"US\",\n \"name\": \"United States\",\n \"divisions_count\": 85000,\n \"subtypes\": [\n \"country\",\n \"region\",\n \"county\",\n \"locality\"\n ]\n },\n {\n \"code\": \"US\",\n \"name\": \"United States\",\n \"divisions_count\": 85000,\n \"subtypes\": [\n \"country\",\n \"region\",\n \"county\",\n \"locality\"\n ]\n }\n ],\n \"total_countries\": 52,\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1977-08-14T04:25:54.414Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15f17ce4-2e10-49c8-b413-55f4e1b4a14c", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "divisions", "countries" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3ac6c51e-237c-48b8-8f08-1774bf473274", "name": "Get divisions database statistics", "request": { "name": "Get divisions database statistics", "description": { "content": "Retrieve statistics about division coverage by country and subtype", "type": "text/plain" }, "url": { "path": [ "divisions", "stats" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2) for country-specific stats" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "0bd69788-f3e6-49e8-9f7f-dbcdaf7385fa", "name": "Divisions statistics", "originalRequest": { "url": { "path": [ "divisions", "stats" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"total_divisions\": 4600000,\n \"countries\": 52,\n \"subtypes\": {\n \"country\": 250,\n \"region\": 5000,\n \"county\": 45000,\n \"locality\": 500000,\n \"neighborhood\": 150000\n },\n \"by_country\": [\n {\n \"country\": \"US\",\n \"count\": 85000,\n \"name\": \"United States\"\n },\n {\n \"country\": \"US\",\n \"count\": 85000,\n \"name\": \"United States\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2011-05-19T17:08:22.757Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ffaba740-f43e-4ece-b511-328a3a9fad02", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "divisions", "stats" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country", "value": "US" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1172af4f-c438-49e0-85d4-0a2cd6ccc97f", "name": "Get random divisions", "request": { "name": "Get random divisions", "description": { "content": "Retrieve random sample divisions, useful for testing and demos", "type": "text/plain" }, "url": { "path": [ "divisions", "random" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "subtype", "value": "locality", "description": "Filter by division type" }, { "disabled": false, "key": "country", "value": "US", "description": "Country code (ISO 3166-1 alpha-2)" }, { "disabled": false, "key": "limit", "value": "10", "description": "Number of random divisions (1-100)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "95e0166e-33b0-4148-959e-3d8586ae455f", "name": "Random divisions", "originalRequest": { "url": { "path": [ "divisions", "random" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "subtype", "value": "locality" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": \"los angeles\",\n \"results\": [\n {\n \"name\": \"Los Angeles\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"subtype\": \"locality\",\n \"country\": \"US\",\n \"region\": \"US-CA\",\n \"population\": 4030904,\n \"wikidata\": \"Q65\",\n \"parent_division_id\": \"9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb\"\n },\n {\n \"name\": \"Los Angeles\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"subtype\": \"locality\",\n \"country\": \"US\",\n \"region\": \"US-CA\",\n \"population\": 4030904,\n \"wikidata\": \"Q65\",\n \"parent_division_id\": \"9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1979-08-26T23:29:19.337Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3dcfa232-fab7-43a0-9d2b-d846ceef685e", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "divisions", "random" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "subtype", "value": "locality" }, { "key": "country", "value": "US" }, { "key": "limit", "value": "10" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4dae7ec9-2776-414a-8596-c0df6089dfc0", "name": "Get division hierarchy", "request": { "name": "Get division hierarchy", "description": { "content": "Get the full hierarchy chain for a division (parent, grandparent, etc.)", "type": "text/plain" }, "url": { "path": [ "divisions", "hierarchy", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Division ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "81ad988c-32cd-474f-bd21-c926f04cb7d7", "name": "Division hierarchy", "originalRequest": { "url": { "path": [ "divisions", "hierarchy", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Division ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"division\": {\n \"name\": \"Los Angeles\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"subtype\": \"locality\",\n \"country\": \"US\",\n \"region\": \"US-CA\",\n \"population\": 4030904,\n \"wikidata\": \"Q65\",\n \"parent_division_id\": \"9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb\"\n },\n \"hierarchy\": [\n {\n \"name\": \"Los Angeles\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"subtype\": \"locality\",\n \"country\": \"US\",\n \"region\": \"US-CA\",\n \"population\": 4030904,\n \"wikidata\": \"Q65\",\n \"parent_division_id\": \"9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb\"\n },\n {\n \"name\": \"Los Angeles\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"subtype\": \"locality\",\n \"country\": \"US\",\n \"region\": \"US-CA\",\n \"population\": 4030904,\n \"wikidata\": \"Q65\",\n \"parent_division_id\": \"9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb\"\n }\n ],\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1948-10-05T03:39:41.906Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a624ce97-252c-423f-8968-c3230ae8b329", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "divisions", "hierarchy", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Division ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "903f7506-7583-42fd-83ef-edf01e14aa8b", "name": "Division not found", "originalRequest": { "url": { "path": [ "divisions", "hierarchy", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Division ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9f80da3f-0fc4-490d-ae2a-5f7a2ad379a0", "name": "Get division by ID", "request": { "name": "Get division by ID", "description": { "content": "Retrieve detailed information about a specific division", "type": "text/plain" }, "url": { "path": [ "divisions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Division ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "a02021f0-90ad-4c5a-a430-8c32e4a22180", "name": "Division details", "originalRequest": { "url": { "path": [ "divisions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Division ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"08f28a8f-8c8b-4896-815e-c92c8df0a8a6\",\n \"name\": \"Los Angeles\",\n \"location\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"subtype\": \"locality\",\n \"country\": \"US\",\n \"region\": \"US-CA\",\n \"population\": 4030904,\n \"area_km2\": 1302.15,\n \"wikidata\": \"Q65\",\n \"parent_division_id\": \"9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb\",\n \"source\": \"Overture Maps Foundation\",\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1988-10-19T04:34:15.559Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8ebf169-61f6-42b6-968a-8b9113b22679", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "divisions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Division ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4335c246-cbe7-45ae-9624-205f165881d8", "name": "Division not found", "originalRequest": { "url": { "path": [ "divisions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6", "key": "id", "description": "(Required) Division ID (Overture ID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "baf10e03-01a6-4836-93b9-be3093d09acc", "name": "Utilities", "description": { "content": "Timezone lookup, distance calculations, and system health", "type": "text/plain" }, "item": [ { "id": "490ca470-ed29-485d-a7c7-fa3db4ec33f6", "name": "Get timezone for coordinates", "request": { "name": "Get timezone for coordinates", "description": { "content": "Lookup the timezone for a given latitude/longitude", "type": "text/plain" }, "url": { "path": [ "timezone" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "lat", "value": "40.7128", "description": "(Required) Latitude" }, { "disabled": false, "key": "lng", "value": "-74.006", "description": "(Required) Longitude" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "9d4f01b1-b4de-4231-86f7-1e467c5e3595", "name": "Timezone information", "originalRequest": { "url": { "path": [ "timezone" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "40.7128" }, { "key": "lng", "value": "-74.006" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"query\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"timezone\": {\n \"id\": \"America/New_York\",\n \"name\": \"Eastern Time\",\n \"utc_offset\": \"-05:00\",\n \"dst_offset\": \"-04:00\",\n \"is_dst\": false\n },\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"1950-03-05T02:00:35.405Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "91595662-b896-4269-835e-5849c762923b", "name": "Bad request", "originalRequest": { "url": { "path": [ "timezone" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "40.7128" }, { "key": "lng", "value": "-74.006" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55441190-6647-40e1-83e4-3552a739acd3", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "timezone" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat", "value": "40.7128" }, { "key": "lng", "value": "-74.006" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "957d6cfa-c171-4bf2-80e0-220979e56b65", "name": "Calculate distance between points", "request": { "name": "Calculate distance between points", "description": { "content": "Calculate the distance between two coordinates using the Haversine formula", "type": "text/plain" }, "url": { "path": [ "distance" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "lat1", "value": "40.7128", "description": "(Required) Latitude of first point" }, { "disabled": false, "key": "lng1", "value": "-74.006", "description": "(Required) Longitude of first point" }, { "disabled": false, "key": "lat2", "value": "38.8977", "description": "(Required) Latitude of second point" }, { "disabled": false, "key": "lng2", "value": "-77.0365", "description": "(Required) Longitude of second point" }, { "disabled": false, "key": "unit", "value": "km", "description": "Unit for distance (km, mi, m)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "db517f03-5c8d-4a2b-b92b-bc34c2286c49", "name": "Distance calculation result", "originalRequest": { "url": { "path": [ "distance" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat1", "value": "40.7128" }, { "key": "lng1", "value": "-74.006" }, { "key": "lat2", "value": "38.8977" }, { "key": "lng2", "value": "-77.0365" }, { "key": "unit", "value": "km" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"from\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"to\": {\n \"lat\": 38.8977,\n \"lng\": -77.0365\n },\n \"distance\": 328.5,\n \"unit\": \"km\",\n \"bearing\": 225.3,\n \"meta\": {\n \"version\": \"v1\",\n \"timestamp\": \"2010-06-26T11:30:51.384Z\",\n \"credits_used\": 1,\n \"credits_remaining\": 9999\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "73ffac2a-411e-4b01-b987-a8307e18b7f9", "name": "Bad request", "originalRequest": { "url": { "path": [ "distance" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat1", "value": "40.7128" }, { "key": "lng1", "value": "-74.006" }, { "key": "lat2", "value": "38.8977" }, { "key": "lng2", "value": "-77.0365" }, { "key": "unit", "value": "km" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2986393e-a17e-4a98-a469-a55beb7cf5cd", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "distance" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "lat1", "value": "40.7128" }, { "key": "lng1", "value": "-74.006" }, { "key": "lat2", "value": "38.8977" }, { "key": "lng2", "value": "-77.0365" }, { "key": "unit", "value": "km" }, { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"invalid_api_key\",\n \"message\": \"The provided API key is invalid or has been revoked.\",\n \"status\": 401,\n \"retry_after\": 45\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "7b50ff54-5f2a-419a-a294-17af35b94b40", "name": "System", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "c925f865-0a1a-4ffe-8b86-bd37edfe7050", "name": "Health check", "request": { "name": "Health check", "description": { "content": "Check API status and version", "type": "text/plain" }, "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "ddc027f6-14bd-4e56-8c0c-4d691f45d51c", "name": "API is healthy", "originalRequest": { "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"ok\",\n \"version\": \"1.0.0\",\n \"timestamp\": \"1973-07-16T09:46:04.051Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "key": "baseUrl", "value": "https://csv2geo.com/api/v1", "type": "string" }, { "key": "api_key", "value": "YOUR_API_KEY", "type": "string", "description": "Get your free API key at csv2geo.com/api-keys" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "api_key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "query" } ] }, "info": { "_postman_id": "0bdce64e-99c4-48e3-aaf0-4bc8f2776946", "name": "CSV2GEO Geocoding API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "## CSV2GEO Geocoding API\n\nThe most feature-rich geocoding API available. 18 endpoints covering address geocoding, reverse geocoding, places search, administrative divisions, and autocomplete.\n\n### Quick Start\n1. Get your free API key at [csv2geo.com/api-keys](https://csv2geo.com/api-keys)\n2. Set the `api_key` variable in this collection\n3. Try any endpoint — 1,000 free requests/day\n\n### Key Features\n- 461M+ rooftop addresses in 200+ countries\n- 72M+ places and points of interest\n- 4.6M+ administrative boundaries\n- Python SDK: `pip install csv2geo`\n- Node.js SDK: `npm install csv2geo-sdk`\n\n### Links\n- [Website](https://csv2geo.com)\n- [API Documentation](https://csv2geo.com/api/geocoding)\n- [GitHub](https://github.com/acenji/csv2geo-api)\n- [Blog](https://csv2geo.com/blog)", "type": "text/markdown" } } }