# 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"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.packli.hu/api-integracio/reference-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.