{
  "info": {
    "name": "Cities & towns (SBX-CITY)",
    "description": "171k cities and towns with population, timezone and coordinates, plus nearest-city search. Turkey's 974 districts and 36k neighbourhood and village postal codes.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{SBX_API_KEY}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.servicebox.io",
      "type": "string"
    },
    {
      "key": "SBX_API_KEY",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "List cities",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/cities/cities",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "cities",
            "cities"
          ],
          "query": [
            {
              "key": "country",
              "value": "string",
              "description": "ISO 3166-1 alpha-2 code.",
              "disabled": true
            },
            {
              "key": "subdivision",
              "value": "string",
              "description": "Subdivision id, e.g. TR.34.",
              "disabled": true
            },
            {
              "key": "q",
              "value": "string",
              "description": "Name search.",
              "disabled": true
            },
            {
              "key": "minPopulation",
              "value": "0",
              "description": "Minimum population.",
              "disabled": true
            },
            {
              "key": "sort",
              "value": "population",
              "description": "`population` (default, largest first) or `name`.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "Cities and towns with at least 1,000 inhabitants (about 171,000 worldwide), largest first unless `sort=name`. Filter by country, subdivision, a name search (start of a word, case- and accent-insensitive: `kadikoy` finds Kadıköy) and a minimum population. Turkish places carry their Turkish names.\n\nCredits: 1"
      }
    },
    {
      "name": "List cities near a point",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/cities/cities/nearby?lat=0&lon=0",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "cities",
            "cities",
            "nearby"
          ],
          "query": [
            {
              "key": "lat",
              "value": "0",
              "description": "Latitude (WGS84).",
              "disabled": false
            },
            {
              "key": "lon",
              "value": "0",
              "description": "Longitude (WGS84).",
              "disabled": false
            },
            {
              "key": "radiusKm",
              "value": "25",
              "description": "Search radius, 0.1–200 km.",
              "disabled": true
            },
            {
              "key": "minPopulation",
              "value": "0",
              "description": "Minimum population.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "Cities within `radiusKm` of a point, nearest first, each with `distanceKm`. Pages through at most the 500 nearest.\n\nCredits: 1"
      }
    },
    {
      "name": "Get a city",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/cities/cities/:id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "cities",
            "cities",
            ":id"
          ],
          "query": [],
          "variable": [
            {
              "key": "id",
              "value": "string",
              "description": ""
            }
          ]
        },
        "description": "One city by its id.\n\nCredits: 1"
      }
    },
    {
      "name": "List districts",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/cities/districts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "cities",
            "districts"
          ],
          "query": [
            {
              "key": "subdivision",
              "value": "string",
              "description": "Subdivision id, e.g. TR.34.",
              "disabled": true
            },
            {
              "key": "country",
              "value": "string",
              "description": "ISO 3166-1 alpha-2 code.",
              "disabled": true
            },
            {
              "key": "q",
              "value": "string",
              "description": "Name search.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "Second-level administrative divisions: Turkey's 974 districts (ilçe) with their Turkish names, counties and similar elsewhere. Give `subdivision` (the districts of one province) or `country`. Sorted by name.\n\nCredits: 1"
      }
    },
    {
      "name": "List postal codes",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/cities/postal-codes?country=string",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "cities",
            "postal-codes"
          ],
          "query": [
            {
              "key": "country",
              "value": "string",
              "description": "ISO 3166-1 alpha-2 code; TR.",
              "disabled": false
            },
            {
              "key": "code",
              "value": "string",
              "description": "A postal code, e.g. 34710.",
              "disabled": true
            },
            {
              "key": "district",
              "value": "string",
              "description": "District id, e.g. TR.34.7732454.",
              "disabled": true
            },
            {
              "key": "subdivision",
              "value": "string",
              "description": "Subdivision id, e.g. TR.34.",
              "disabled": true
            },
            {
              "key": "q",
              "value": "string",
              "description": "Place name search.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "Postal codes with the places they serve: for Turkey, about 36,000 neighbourhoods (mahalle) and villages, each with its district and province. Filter by `code`, `district`, `subdivision` or a name search. `country` is required; available for TR.\n\nCredits: 1"
      }
    },
    {
      "name": "List timezones",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/cities/timezones",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "cities",
            "timezones"
          ],
          "query": [],
          "variable": []
        },
        "description": "Every IANA timezone the cities use, with its city count, sorted by name. Free. Not paged: the whole list in one answer.\n\nCredits: 0"
      }
    }
  ]
}