Reference Data

Reference data endpoints (countries, providers, etc.)

List countries

get

Retrieve a list of all available countries

Authorizations

BearerAuth

AuthorizationstringRequired

Laravel Sanctum token authentication. Include the token in the Authorization header: Bearer {your-token}

Responses

200

List of countries

application/json

idintegerOptional

Country ID

Example: 1

namestringOptional

Country name

Example: Hungary

isostringOptional

ISO country code (lowercase)

Example: hu

currency_idintegerOptional

Currency ID

Example: 1

cod_payout_limitnumberOptional

Cash on delivery payout limit

Example: 50000

vatnumberOptional

VAT rate percentage

Example: 27

401

Authentication required

application/json

get

/v3/countries

HTTPcURLJavaScriptPython

GET /api/v3/countries HTTP/1.1
Host: app.packli.hu
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "name": "Hungary",
    "iso": "hu",
    "currency_id": 1,
    "cod_payout_limit": 50000,
    "vat": 27
  },
  {
    "id": 2,
    "name": "Romania",
    "iso": "ro",
    "currency_id": 1,
    "cod_payout_limit": 0,
    "vat": 0
  },
  {
    "id": 6,
    "name": "Austria",
    "iso": "at",
    "currency_id": 1,
    "cod_payout_limit": 0,
    "vat": 0
  },
  {
    "id": 10,
    "name": "Germany",
    "iso": "de",
    "currency_id": 1,
    "cod_payout_limit": 0,
    "vat": 0
  }
]

List providers

get

Retrieve a list of all shipping providers

Authorizations

BearerAuth

AuthorizationstringRequired

Laravel Sanctum token authentication. Include the token in the Authorization header: Bearer {your-token}

Responses

200

List of providers

application/json

idintegerOptional

Provider ID

Example: 1

namestringOptional

Provider name

Example: Magyar Posta Logisztika

slugstringOptional

Provider slug

Example: mpl

tracking_linkstringOptional

Tracking link template with %foreign_tracking_id% placeholder

Example: https://posta.hu/ugyfelszolgalat/nyomkovetes?ids=%foreign_tracking_id%

401

Authentication required

application/json

get

/v3/providers

HTTPcURLJavaScriptPython

GET /api/v3/providers HTTP/1.1
Host: app.packli.hu
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "name": "Magyar Posta Logisztika",
    "slug": "mpl",
    "tracking_link": "https://posta.hu/ugyfelszolgalat/nyomkovetes?ids=%foreign_tracking_id%"
  },
  {
    "id": 2,
    "name": "DPD",
    "slug": "dpd",
    "tracking_link": "https://www.dpdgroup.com/hu/mydpd/my-parcels/incoming?parcelNumber=%foreign_tracking_id%"
  },
  {
    "id": 3,
    "name": "Packeta",
    "slug": "pck",
    "tracking_link": "https://tracking.packeta.com/hu"
  },
  {
    "id": 4,
    "name": "GLS",
    "slug": "gls",
    "tracking_link": "https://gls-group.eu/HU/hu/csomagkovetes?match=%foreign_tracking_id%"
  },
  {
    "id": 5,
    "name": "Foxpost",
    "slug": "fxp",
    "tracking_link": "https://foxpost.hu/csomagkovetes/?code=%foreign_tracking_id%"
  }
]

Search provider places

get

Search for provider pickup/drop-off places

Authorizations

BearerAuth

AuthorizationstringRequired

Laravel Sanctum token authentication. Include the token in the Authorization header: Bearer {your-token}

Query parameters

provider_service_ids[]integer[]Optional

Filter by provider service IDs

Example: [1,2,3]

country_idintegerOptional

Filter by country ID

Example: 1

searchstringOptional

Search term for place names or locations

Example: Budapest

pageinteger · min: 1Required

Page number for pagination

Default: 1

limitinteger · min: 1Required

Number of items per page

Default: 10

Responses

200

List of provider places

application/json

current_pageintegerOptionalExample: 1

first_page_urlstringOptionalExample: http://localhost:8000/api/v3/provider-places?page=1

fromintegerOptionalExample: 1

last_pageintegerOptionalExample: 1230

last_page_urlstringOptionalExample: http://localhost:8000/api/v3/provider-places?page=1230

next_page_urlstring · nullableOptionalExample: http://localhost:8000/api/v3/provider-places?page=2

pathstringOptionalExample: http://localhost:8000/api/v3/provider-places

per_pageintegerOptionalExample: 10

prev_page_urlstring · nullableOptional

tointegerOptionalExample: 10

totalintegerOptionalExample: 12292

401

Authentication required

application/json

422

Validation failed

application/json

get

/v3/provider-places

HTTPcURLJavaScriptPython

GET /api/v3/provider-places?page=1&limit=10 HTTP/1.1
Host: app.packli.hu
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "current_page": 1,
  "data": [
    {
      "id": 5000000,
      "provider_service_id": 2,
      "foreign_id": "107852",
      "name": "277 sz. automata - XIX. Citroen u Mobil Petrol",
      "contact_id": 5000000,
      "delivery_available": 1,
      "pickup_available": 0,
      "meta": "{\"hours\": [[\"00:00\", \"23:59\"], [\"00:00\", \"23:59\"], [\"00:00\", \"23:59\"], [\"00:00\", \"23:59\"], [\"00:00\", \"23:59\"], [\"00:00\", \"23:59\"], [\"00:00\", \"23:59\"]], \"description\": \"N/A...\"}",
      "created_at": "2025-08-05T08:49:13.000000Z",
      "updated_at": "2025-08-05T08:49:13.000000Z",
      "account_id": null,
      "country_id": 1,
      "is_warehouse": 0,
      "is_billing": 0,
      "zip": "1826",
      "city": "Budapest",
      "address": "Citroen utca 2",
      "position_lat": 47.438068,
      "position_lng": 19.145779,
      "phone": "",
      "email": "[email protected]",
      "family_name": null,
      "first_name": null,
      "company_name": "Magyar Posta Logisztika",
      "dpd_buCode": null,
      "dpd_customerId": null,
      "dpd_addressId": null,
      "deleted_at": null,
      "contact": {
        "id": 5000000,
        "account_id": null,
        "country_id": 1,
        "is_warehouse": 0,
        "is_billing": 0,
        "zip": "1826",
        "city": "Budapest",
        "address": "Citroen utca 2",
        "position_lat": 47.438068,
        "position_lng": 19.145779,
        "phone": "",
        "email": "[email protected]",
        "family_name": null,
        "first_name": null,
        "company_name": "Magyar Posta Logisztika",
        "dpd_buCode": null,
        "dpd_customerId": null,
        "dpd_addressId": null,
        "deleted_at": null,
        "created_at": "2025-08-05T08:49:13.000000Z",
        "updated_at": "2025-08-05T08:49:13.000000Z",
        "country": {
          "id": 1,
          "name": "Hungary",
          "iso": "hu",
          "currency_id": 1,
          "cod_payout_limit": 50000,
          "vat": 27,
          "created_at": "-000001-11-30T00:00:00.000000Z",
          "updated_at": "-000001-11-30T00:00:00.000000Z"
        }
      },
      "provider": {
        "id": 1,
        "name": "Magyar Posta Logisztika",
        "slug": "mpl",
        "tracking_link": "https://posta.hu/ugyfelszolgalat/nyomkovetes?ids=%foreign_tracking_id%",
        "created_at": "2024-10-10T11:39:29.000000Z",
        "updated_at": "2025-09-09T09:02:15.000000Z",
        "laravel_through_key": 2
      },
      "service": {
        "id": 2,
        "provider_id": 1,
        "country_id": 1,
        "slug": "parcellocker",
        "is_default": 1,
        "full_address_required": 0,
        "maximum_weight": 20,
        "supported_sizes": "[\"xs\", \"s\", \"m\"]",
        "is_support_amorf": 0,
        "is_support_fragile": 1,
        "is_support_priority": 1
      }
    }
  ],
  "first_page_url": "http://localhost:8000/api/v3/provider-places?page=1",
  "from": 1,
  "last_page": 1230,
  "last_page_url": "http://localhost:8000/api/v3/provider-places?page=1230",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "page": null,
      "active": false
    },
    {
      "url": "http://localhost:8000/api/v3/provider-places?page=1",
      "label": "1",
      "page": 1,
      "active": true
    },
    {
      "url": "http://localhost:8000/api/v3/provider-places?page=2",
      "label": "Next »",
      "page": 2,
      "active": false
    }
  ],
  "next_page_url": "http://localhost:8000/api/v3/provider-places?page=2",
  "path": "http://localhost:8000/api/v3/provider-places",
  "per_page": 10,
  "prev_page_url": null,
  "to": 10,
  "total": 12292
}