API Documentation

Check mail delivery status for a Swedish zip code from PostNord and CityMail.

Endpoint

GET /zip/:postalCode

Parameters

Parameter	Type	Description
`postalCode`	string	Swedish postal code, e.g. `11234`

Example request

GET /zip/11234

Example response

{
  "zip": "11234",
  "today": true,
  "citymail": {
    "delivery": "2026-04-01",
    "today": true
  },
  "postnord": {
    "delivery": "1 april, 2026",
    "today": true
  }
}

Response fields

Field	Type	Description
`zip`	string	The queried postal code
`today`	boolean	`true` if either carrier delivers today
`citymail.delivery`	string	Next CityMail delivery date (YYYY-MM-DD)
`citymail.today`	boolean	`true` if CityMail delivers today
`postnord.delivery`	string	Next PostNord delivery date (Swedish format)
`postnord.today`	boolean	`true` if PostNord delivers today

Caching

Responses are cached per postal code until midnight Swedish time (Europe/Stockholm).