Available Couriers

The Kvikk Map widget supports multiple courier services across various countries. Each courier has different pickup point types available in specific countries.

---

Courier List

The widget supports the following couriers with their respective pickup point types:

Courier Name	Courier Code	Point Type	Type Code	Countries
DHL	dhl	AlzaBox	alzabox	HU
DHL	dhl	Shell	shell	HU
DHL	dhl	Locker	locker	HU
DHL	dhl	Service Point	service-point	HU
DPD	dpd	Csomagpont	parcelshop	HU, RO, HR, CZ, SI, SK, DE, AT, PL, GR, IT, FR, DK, NL, BE, BG, LV, LT, EE, IE, SE, LU, PT, FI, ES
DPD	dpd	AlzaBox	alzabox	HU, CZ, SK
Express One	expressone	AlzaBox	alzabox	HU
Express One	expressone	OMV	omv	HU
Express One	expressone	Automata	exobox	HU
Foxpost	foxpost	Foxpost	foxpost	HU
GLS	gls	Csomagautomata	locker	HU, AT, BE, HR, CZ, FI, FR, DE, GR, LV, LT, NL, PL, RO, SK, SI, ES
GLS	gls	CsomagPont	shop	HU, AT, BE, BG, HR, CZ, DK, FI, FR, DE, GR, IE, IT, LV, LT, LU, NL, PL, PT, RO, SK, SI, ES, SE
MPL	mpl	Posta	posta	HU
MPL	mpl	Csomagautomata	automata	HU
MPL	mpl	PostaPont	postapont	HU
Packeta	packeta	Z-Box	zbox	HU, CZ, SK, RO
Packeta	packeta	Z-Pont	zpont	HU, CZ, SK, RO
Sameday	sameday	Easybox	easybox	HU, RO
Sameday	sameday	Pick Pack Pont	pick-pack-pont	HU

---

Configuration Format

When configuring the widget, specify couriers using this format:

couriers: [
  {
    courier: "mpl",      // Courier slug
    type: "postapont",   // Point type code
    price: {
      hu: 1200,          // Price in Hungarian Forints
    },
  },
  {
    courier: "gls",
    type: "shop",
    price: {
      hu: 1500,
      ro: 2500,          // Multiple countries supported
    },
  },
]

---

Multi-Country Support

When operating in multiple countries, configure prices for each:

{
  courier: "gls",
  type: "shop",
  price: {
    hu: 1500,  // Hungary
    ro: 2500,  // Romania
    sk: 2800,  // Slovakia
    at: 3200,  // Austria
  },
}

Points in countries without a configured price will not be available for selection.

---

API Endpoint

Retrieve the complete list of available couriers and their point types:

GET https://points-api.kvikk.hu/map/couriers

Required Header:

x-api-key: your_api_key_here

Response format:

{
  "status": "success",
  "code": "map_couriers_retrieved",
  "message": "Map couriers successfully retrieved",
  "data": [
    {
      "name": "MPL",
      "slug": "mpl",
      "pointTypes": [
        {
          "name": "Postán maradó",
          "slug": "posta",
          "countries": [
            {
              "country": "HU",
              "items": 2847
            }
          ]
        },
        {
          "name": "Postapont",
          "slug": "postapont",
          "countries": [
            {
              "country": "HU",
              "items": 1523
            }
          ]
        }
      ]
    }
  ]
}

---

Coverage Information

The items field in the API response indicates the number of pickup points available for each courier/type/country combination. Use this to:

• Show coverage statistics to users
• Determine which options to offer
• Filter out unavailable combinations

---

Need More Couriers?

If you need support for additional couriers or regions, contact [email protected] or visit our support portal.