Documentation

Get all available postal codes

With this easy to use endpoint you will get a list of Postal codes. The request example will return a list of all greek postal codes,street,city and state.

getAllCodes

GET https://beta.greek-postal-codes.gr/1/getAllCodes

result example

{
  "data": [
    {
      "street": "ΤΡΙΑ ΜΑΓΑΖΙΑ",
      "tk": 34100,
      "city": "ΧΑΛΚΙΔΑ",
      "state": "ΕΥΒΟΙΑΣ"
    },
    {
      "street": "ΜΕΣΟΓΕΙΩΝ",
      "tk": 15125,
      "city": "ΜΑΡΟΥΣΙ",
      "state": "ΑΤΤΙΚΗΣ"
    },
    {
      "street": "ΤΡΙΤΣΗ ΑΝΤ.",
      "tk": 15235,
      "city": "ΧΑΛΑΝΔΡΙ",
      "state": "ΑΤΤΙΚΗΣ"
    }
  ],
}

Get by postal code

You can get results by simply pass as a parameter the postal code you want.

getTk

GET https://beta.greek-postal-codes.gr/1/getTk?tk=15125

result example

{
  "data": [
    {
      "street": "ΦΛΟΙΑΣ",
      "tk": 15125,
      "city": "ΜΑΡΟΥΣΙ",
      "state": "ΑΤΤΙΚΗΣ"
    },
    {
      "street": "ΑΓΙΟΥ ΑΘΑΝΑΣΙΟΥ",
      "tk": 15125,
      "city": "ΜΑΡΟΥΣΙ",
      "state": "ΑΤΤΙΚΗΣ"
    },
    {
      "street": "ΑΓΙΟΥ ΓΕΩΡΓΙΟΥ (ΣΩΡΟΣ)",
      "tk": 15125,
      "city": "ΜΑΡΟΥΣΙ",
      "state": "ΑΤΤΙΚΗΣ"
    }
  ]
}

Get by city

Like we did before on the postal code example you can get results by simply pass as a parameter the city you want.

getCity

GET https://beta.greek-postal-codes.gr/1/getCity?city=ΧΑΛΚΙΔΑ

result example

{
  "data": [
    {
      "street": "ΑΦΡΑΤΙΟΝ",
      "tk": 34100,
      "city": "ΧΑΛΚΙΔΑ",
      "state": "ΕΥΒΟΙΑΣ"
    },
    {
      "street": "ΒΑΘΥ ΑΥΛΙΔΟΣ",
      "tk": 34100,
      "city": "ΧΑΛΚΙΔΑ",
      "state": "ΕΥΒΟΙΑΣ"
    },
    {
      "street": "ΔΡΟΣΙΑ",
      "tk": 34100,
      "city": "ΧΑΛΚΙΔΑ",
      "state": "ΕΥΒΟΙΑΣ"
    }
  ]
}

Get by state

One more simple example for how to get all the data for Attica.You can do the same for any other state.

getState

GET https://beta.greek-postal-codes.gr/1/getState?state=ΑΤΤΙΚΗΣ

result example

{
  "data": [
    {
      "street": "3ΗΣ (Γ') ΣΕΠΤΕΜΒΡΙΟΥ",
      "tk": 10431,
      "city": "ΑΘΗΝΑ",
      "state": "ΑΤΤΙΚΗΣ"
    },
    {
      "street": "ΑΓΙΟΥ ΚΩΝΣΤΑΝΤΙΝΟΥ",
      "tk": 10431,
      "city": "ΑΘΗΝΑ",
      "state": "ΑΤΤΙΚΗΣ"
    },
    {
      "street": "ΒΕΝΙΖΕΛΟΥ ΕΛΕΥΘΕΡΙΟΥ",
      "tk": 10564,
      "city": "ΑΘΗΝΑ",
      "state": "ΑΤΤΙΚΗΣ"
    }
  ]
}

Last updated on December 17, 2023

Home