GET

Lookup Postal Code

https://0otcsk4qig.execute-api.ap-northeast-1.amazonaws.com/prod/api/postal-codes/:code

Retrieve address information for a given 5-digit Pakistan postal code. Returns province, city, area details, and a Plus Code (Open Location Code) for map integration.

Parameters

:codestringrequired5-digit postal code (e.g. 54830)

Example Request

GET https://0otcsk4qig.execute-api.ap-northeast-1.amazonaws.com/prod/api/postal-codes/54830

Example Response

{
  "results": [
    {
      "postal_code": "54830",
      "area_name": "DHA phase 3",
      "city": "Lahore",
      "province": "Punjab",
      "plus_code": "8J3VMRG5+XX"
    }
  ],
  "count": 1
}

Status Codes

200Success
400Bad Request — Invalid format or missing parameters
404Not Found — Postal code does not exist
429Rate Limited — Exceeded 1,000 requests/day
500Internal Server Error