> For the complete documentation index, see [llms.txt](https://docs.packli.hu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.packli.hu/api-integracio/reference-data.md).

# Reference Data

Reference data endpoints (countries, providers, etc.)

## List countries

> Retrieve a list of all available countries

```json
{"openapi":"3.0.3","info":{"title":"Packli API","version":"3.0.0"},"tags":[{"name":"Reference Data","description":"Reference data endpoints (countries, providers, etc.)"}],"servers":[{"url":"https://app.packli.hu/api","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Laravel Sanctum token authentication.\nInclude the token in the Authorization header: `Bearer {your-token}`\n"}},"schemas":{"Country":{"type":"object","properties":{"id":{"type":"integer","description":"Country ID"},"name":{"type":"string","description":"Country name"},"iso":{"type":"string","description":"ISO country code (lowercase)"},"currency_id":{"type":"integer","description":"Currency ID"},"cod_payout_limit":{"type":"number","description":"Cash on delivery payout limit"},"vat":{"type":"number","description":"VAT rate percentage"}}}},"responses":{"Unauthorized":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}},"paths":{"/v3/countries":{"get":{"tags":["Reference Data"],"summary":"List countries","description":"Retrieve a list of all available countries","responses":{"200":{"description":"List of countries","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Country"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## List providers

> Retrieve a list of all shipping providers

```json
{"openapi":"3.0.3","info":{"title":"Packli API","version":"3.0.0"},"tags":[{"name":"Reference Data","description":"Reference data endpoints (countries, providers, etc.)"}],"servers":[{"url":"https://app.packli.hu/api","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Laravel Sanctum token authentication.\nInclude the token in the Authorization header: `Bearer {your-token}`\n"}},"schemas":{"Provider":{"type":"object","properties":{"id":{"type":"integer","description":"Provider ID"},"name":{"type":"string","description":"Provider name"},"slug":{"type":"string","description":"Provider slug"},"tracking_link":{"type":"string","description":"Tracking link template with %foreign_tracking_id% placeholder"}}}},"responses":{"Unauthorized":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}},"paths":{"/v3/providers":{"get":{"tags":["Reference Data"],"summary":"List providers","description":"Retrieve a list of all shipping providers","responses":{"200":{"description":"List of providers","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```

## Search provider places

> Search for provider pickup/drop-off places

```json
{"openapi":"3.0.3","info":{"title":"Packli API","version":"3.0.0"},"tags":[{"name":"Reference Data","description":"Reference data endpoints (countries, providers, etc.)"}],"servers":[{"url":"https://app.packli.hu/api","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Laravel Sanctum token authentication.\nInclude the token in the Authorization header: `Bearer {your-token}`\n"}},"schemas":{"ProviderPlace":{"type":"object","properties":{"id":{"type":"integer","description":"Provider place ID"},"provider_service_id":{"type":"integer","description":"Provider service ID"},"foreign_id":{"type":"string","description":"External provider ID"},"name":{"type":"string","description":"Place name"},"contact_id":{"type":"integer","description":"Contact ID"},"delivery_available":{"type":"integer","description":"Whether delivery is available (1/0)"},"pickup_available":{"type":"integer","description":"Whether pickup is available (1/0)"},"meta":{"type":"string","description":"JSON metadata with hours and description"},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp"},"updated_at":{"type":"string","format":"date-time","description":"Last update timestamp"},"account_id":{"type":"integer","nullable":true,"description":"Account ID"},"country_id":{"type":"integer","description":"Country ID"},"is_warehouse":{"type":"integer","description":"Whether this is a warehouse (1/0)"},"is_billing":{"type":"integer","description":"Whether this is a billing address (1/0)"},"zip":{"type":"string","description":"Postal code"},"city":{"type":"string","description":"City"},"address":{"type":"string","description":"Address"},"position_lat":{"type":"number","description":"Latitude coordinate"},"position_lng":{"type":"number","description":"Longitude coordinate"},"phone":{"type":"string","description":"Phone number"},"email":{"type":"string","description":"Email address"},"family_name":{"type":"string","nullable":true,"description":"Family name"},"first_name":{"type":"string","nullable":true,"description":"First name"},"company_name":{"type":"string","description":"Company name"},"dpd_buCode":{"type":"string","nullable":true,"description":"DPD business unit code"},"dpd_customerId":{"type":"string","nullable":true,"description":"DPD customer ID"},"dpd_addressId":{"type":"string","nullable":true,"description":"DPD address ID"},"deleted_at":{"type":"string","nullable":true,"format":"date-time","description":"Deletion timestamp"},"contact":{"$ref":"#/components/schemas/ProviderPlaceContact"},"provider":{"$ref":"#/components/schemas/ProviderPlaceProvider"},"service":{"$ref":"#/components/schemas/ProviderPlaceService"}}},"ProviderPlaceContact":{"type":"object","properties":{"id":{"type":"integer"},"account_id":{"type":"integer","nullable":true},"country_id":{"type":"integer"},"is_warehouse":{"type":"integer"},"is_billing":{"type":"integer"},"zip":{"type":"string"},"city":{"type":"string"},"address":{"type":"string"},"position_lat":{"type":"number"},"position_lng":{"type":"number"},"phone":{"type":"string"},"email":{"type":"string"},"family_name":{"type":"string","nullable":true},"first_name":{"type":"string","nullable":true},"company_name":{"type":"string"},"dpd_buCode":{"type":"string","nullable":true},"dpd_customerId":{"type":"string","nullable":true},"dpd_addressId":{"type":"string","nullable":true},"deleted_at":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"country":{"$ref":"#/components/schemas/Country"}}},"Country":{"type":"object","properties":{"id":{"type":"integer","description":"Country ID"},"name":{"type":"string","description":"Country name"},"iso":{"type":"string","description":"ISO country code (lowercase)"},"currency_id":{"type":"integer","description":"Currency ID"},"cod_payout_limit":{"type":"number","description":"Cash on delivery payout limit"},"vat":{"type":"number","description":"VAT rate percentage"}}},"ProviderPlaceProvider":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"tracking_link":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"laravel_through_key":{"type":"integer"}}},"ProviderPlaceService":{"type":"object","properties":{"id":{"type":"integer"},"provider_id":{"type":"integer"},"country_id":{"type":"integer"},"slug":{"type":"string"},"is_default":{"type":"integer"},"full_address_required":{"type":"integer"},"maximum_weight":{"type":"number"},"supported_sizes":{"type":"string","description":"JSON array of supported sizes"},"is_support_amorf":{"type":"integer"},"is_support_fragile":{"type":"integer"},"is_support_priority":{"type":"integer"}}},"PaginationLink":{"type":"object","properties":{"url":{"type":"string","nullable":true,"description":"Link URL"},"label":{"type":"string","description":"Link label"},"page":{"type":"integer","nullable":true,"description":"Page number"},"active":{"type":"boolean","description":"Whether this is the current page"}}}},"responses":{"Unauthorized":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"ValidationError":{"description":"Validation failed","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}}}}}},"paths":{"/v3/provider-places":{"get":{"tags":["Reference Data"],"summary":"Search provider places","description":"Search for provider pickup/drop-off places","parameters":[{"name":"provider_service_ids[]","in":"query","description":"Filter by provider service IDs","required":false,"schema":{"type":"array","items":{"type":"integer"}},"style":"form","explode":true},{"name":"country_id","in":"query","description":"Filter by country ID","required":false,"schema":{"type":"integer"}},{"name":"search","in":"query","description":"Search term for place names or locations","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Page number for pagination","required":true,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","description":"Number of items per page","required":true,"schema":{"type":"integer","minimum":1,"default":10}}],"responses":{"200":{"description":"List of provider places","content":{"application/json":{"schema":{"type":"object","properties":{"current_page":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ProviderPlace"}},"first_page_url":{"type":"string"},"from":{"type":"integer"},"last_page":{"type":"integer"},"last_page_url":{"type":"string"},"links":{"type":"array","items":{"$ref":"#/components/schemas/PaginationLink"}},"next_page_url":{"type":"string","nullable":true},"path":{"type":"string"},"per_page":{"type":"integer"},"prev_page_url":{"type":"string","nullable":true},"to":{"type":"integer"},"total":{"type":"integer"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"422":{"$ref":"#/components/responses/ValidationError"}}}}}}
```