Packeta PUDOs
The endpoints below refer to the __API_KEY__. You can locate it in the client section under the User Support category.
Not updating your Packeta Pick-up Point / boxes data regularly can lead to issues during the packet creation or delivery process.
-
Minimum frequency is once a day.
-
Recommended update of Packeta pick-up point / boxes data is 4 times a day between 7:00 - 21:00.
-
Up to every hour between 7:00 - 21:00 during season time (October - December).
Processing speed optimizationRequest feed at times 'in between', like 14:23 | 17:37 | 19:56, rather than on the hour.
Calling it more than once an hour also isn't necessary, as the data is cached and result will be same.
Feed for Packeta Pick-up Points
This feed includes details about all the branches that are presently operational.
Access to the feed is available through the following URL:
https://pickup-point.api.packeta.com/v5/__API_KEY__/branch/json
Feed for Packeta Z-BOXes
This feed includes information about all the boxes currently in operation.
Access to the feed is available through the following URL:
https://pickup-point.api.packeta.com/v5/__API_KEY__/box/json
List of Carriers
The feeds mentioned above only consist of standard branches and boxes, as they are predominantly used to create a selectable list for the end consumer. However, should you consider our home delivery services, whether exclusively in the Czech Republic or abroad, you would need to procure a list of our home delivery options.
A home delivery option is symbolized by a branch entry, and is similarly considered as such when producing a packet entry within our system. Simply use its ID in the same manner you would for a standard branch.
Access to the list is available through the following URL:
https://pickup-point.api.packeta.com/v5/__API_KEY__/carrier/json
Filters
Below you can see the available filters for box and branch feed. The filters are not applicable on list of carriers.
| Name | Description |
|---|---|
| lang | Filter by language. Two-letter ISO 639-1 format country code. en, cs, sk are supported. |
| country | Filter by country. Two-letter ISO 3166-1 alpha-2 format country code. |
HTTP Status codes
Table below outlines the possible HTTP responses for requests, along with their reasons and additional comments for clarification. More details about HTTP status codes can be found on Wikipedia.
| Code | Status | Description |
|---|---|---|
| 200 | OK | |
| 401 | Unauthorized | Incorrect credentials |
| 404 | Not found | |
| 409 | Conflict | The feed generation was executed from another request and its still running. Try request later. |
| 415 | Unsupported Media Type | Requested invalid format of feed |
Data specifications
Branches
[
{
"id": "13789",
"name": "Praha 15, Hostivař, Švehlova 32 (ZÁSILKOVNA, VIVO Hostivař)",
"special": "vstup z ul. Otakarova",
"place": "ZÁSILKOVNA",
"street": "Švehlova 32",
"city": "Praha",
"zip": "102 00",
"country": "cz",
"currency": "CZK",
"status": {
"statusId": "1",
"description": "In operation"
},
"displayFrontend": "1",
"exportedUntil": "2026-04-06",
"enterableUntil": "2026-04-13",
"openUntil": "2026-04-20",
"openSince": "2026-04-01",
"directions": "<p>Výdejní místo Zásilkovny se nachází v 1. patře obchodního centra nedaleko jídelní zóny.</p>",
"directionsCar": "<p>Bezproblémové parkování přímo u obchodního centra.</p>",
"directionsPublic": "<p>Zastávka městské dopravy Obchodní centrum Hostivař se nachází přímo před obchodním centrem.</p>",
"wheelchairAccessible": "yes",
"creditCardPayment": "yes",
"dressingRoom": "0",
"claimAssistant": "1",
"packetConsignment": "1",
"latitude": "50.05341",
"longitude": "14.51784",
"url": "https://www.zasilkovna.cz/pobocky/praha-15-hostivar-svehlova-32-zasilkovna-vivo-hostivar",
"maxWeight": "15",
"holidayStart": "2026-02-28",
"holidayEnd": "2026-03-22",
"labelRouting": "C10-252-13789",
"labelName": "Praha 15, Hostivař, Švehlova 32 (ZÁSILKOVNA, VIVO Hostivař)",
"photos": [
{
"thumbnail": "https://files.packeta.com/points/thumb/point_13789_91aedcb9489d.jpg",
"normal": "https://files.packeta.com/points/normal/point_13789_91aedcb9489d.jpg"
},
{
"thumbnail": "https://files.packeta.com/points/thumb/point_13789_f8e5bdcf521a.jpg",
"normal": "https://files.packeta.com/points/normal/point_13789_f8e5bdcf521a.jpg"
},
{
"thumbnail": "https://files.packeta.com/points/thumb/point_13789_930732f7d191.jpg",
"normal": "https://files.packeta.com/points/normal/point_13789_930732f7d191.jpg"
}
],
"openingHours": {
"regular": {
"monday": "09:00–21:00",
"tuesday": "09:00–21:00",
"wednesday": "09:00–21:00",
"thursday": "09:00–21:00",
"friday": "09:00–21:00",
"saturday": "10:00–21:00",
"sunday": "10:00–21:00"
},
"upcoming": {
"monday": "08:30-18:30",
"tuesday": "08:30-18:30",
"wednesday": "08:30-18:30",
"thursday": "08:30-18:30",
"friday": "08:30-18:30",
"saturday": "08:30-14:00",
"sunday": "08:30-14:00",
"startDate": "2025-08-23"
},
"exceptions": [
{
"date": "2025-12-30",
"hours": "08:00-12:00, 12:45-16:30"
},
{
"date": "2025-12-31",
"hours": "12:00–18:00"
}
]
},
"extendedDelivery": {
"saturday": "true"
}
}
]
Branch attributes
| Name | Mandatory | Type | Description |
|---|---|---|---|
| id | Yes | Integer | A unique id. |
| name | Yes | String | Branch name. |
| special | No | String | Special orientation feature of the location. |
| place | Yes | String | Name of the place hosting the branch i.e. Baker & Sons bakery. |
| street | Yes | String | Street name and number. |
| city | Yes | String | City. |
| zip | Yes | String | Zip code. Contains spaces based on standard country format. |
| country | Yes | String | Country code. |
| currency | Yes | String | Currency code accepted by the branch. |
| status | Yes | Object | Container for the status code and status message of the branch. See status. |
| displayFrontend | Yes | Integer | Indicates whether the branch is supposed to be shown to the end customer. If the value equals '0', the branch is intended to be used only for your administrative purposes. |
| exportedUntil | No | Date | If the branch is scheduled to close, the field contains date when the branch is last contained in the export. The format is YYYY-MM-DD. |
| enterableUntil | No | Date | If the branch is scheduled to close, the field contains last date when our system will accept packet data for this branch. The format is YYYY-MM-DD. |
| openUntil | No | Date | If the branch is scheduled to close, the field contains last date of the branch being open for pick up of delivered packets. The format is YYYY-MM-DD. |
| openSince | No | Date | If the branch is scheduled to open, the field contains the first date of the branch being open for pick up of delivered packets. The format is YYYY-MM-DD. |
| directions | No | String | HTML directions to the branch. If empty, it is an object. |
| directionsCar | No | String | HTML directions to the branch when travelling by car. |
| directionsPublic | No | String | HTML directions to the branch when travelling via public transport. |
| wheelchairAccessible | Yes | String | Indicates whether the branch is wheelchair accessible. |
| creditCardPayment | Yes | String | Indicates whether the branch accepts credit card as payment option. |
| dressingRoom | Yes | Integer | Indicates whether the branch has a dressing room. |
| claimAssistant | Yes | Integer | Indicates whether the branch accepts Claim Assistant packets. |
| packetConsignment | Yes | Integer | Indicates whether the branch accepts packet consignment. |
| latitude | Yes | Decimal | Latitude. |
| longitude | Yes | Decimal | Longitude. |
| url | Yes | String | URL with branch information. |
| maxWeight | Yes | Integer | Maximal weight of the packet the branch is able to handle. |
| holidayStart | No | Date | The date of the start of the holiday. If the branch is contiuously closed for at least 7 days, the time is considered a holiday. This field is present at most 14 days before the start of the holiday. |
| holidayEnd | No | Date | The date of the end of the holiday. |
| labelRouting | No | String | Routing code of the branch. Used for custom labels. |
| labelName | No | String | Branch name for printing on custom labels. |
| photos | Yes | Object | Container for photo elements. |
| openingHours | Yes | Object | Container for opening hours information. See openingHours documentation. |
| extendedDelivery | Yes | Object | Container for additional delivery details. Featuring Saturday delivery. |
status
Contained once by branches.
Contains a status code and a message. The language of the status message is determined by the lang GET parameter. If no lang parameter is supplied, default value en is used.
{
"statusId": "1",
"description": "In operation"
}
| Name | Type | Description |
|---|---|---|
| statusId | Integer | Numeric code of branch status. |
| description | String | Text message of the branch status in chosen language. |
List of statuses
| Status code | Description |
|---|---|
| 1 | In operation. |
| 2 | Temporarily does not receive packets due to exceeded capacity. |
| 3 | Temporarily closed due to holiday. |
| 4 | Temporarily does not receive packets due to technical reasons. |
| 5 | The branch has ended cooperation and no longer accepts new packets. |
photo
Contained zero to many times by photos attribte.
{
"thumbnail": "https://files.packeta.com/points/thumb/point_13789_f8e5bdcf521a.jpg",
"normal": "https://files.packeta.com/points/normal/point_13789_f8e5bdcf521a.jpg"
}
| Name | Type | Description |
|---|---|---|
| thumbnail | String | URL of a thumbnail image 160px*120px. |
| normal | String | URL of a image 720px*540px. |
openingHours
Contained once by branch and box attribute.
{
"regular": {
"monday": "09:00–21:00",
"tuesday": "09:00–21:00",
"wednesday": "09:00–21:00",
"thursday": "09:00–21:00",
"friday": "09:00–21:00",
"saturday": "10:00–21:00",
"sunday": "10:00–21:00"
},
"upcoming": {
"monday": "08:30-18:30",
"tuesday": "08:30-18:30",
"wednesday": "08:30-18:30",
"thursday": "08:30-18:30",
"friday": "08:30-18:30",
"saturday": "08:30-14:00",
"sunday": "08:30-14:00",
"startDate": "2025-08-23"
},
"exceptions": [
{
"date": "2025-12-30",
"hours": "08:00-12:00, 12:45-16:30"
},
{
"date": "2025-12-31",
"hours": "12:00–18:00"
}
]
}
| Name | Type | Description |
|---|---|---|
| regular | Object | Container for opening hours by day. See documentation for regular element. |
| upcoming | Object | Container for upcoming opening hours by day. See documentation for upcoming element. |
| exceptions | Object | Container for exception elements. |
regular
Contained once by openingHours attribute.
Contains opening hours for each day in day-named elements. In the table below we only show monday since the same applies for other week days.
{
"monday": "09:00–21:00",
"tuesday": "09:00–21:00",
"wednesday": "09:00–21:00",
"thursday": "09:00–21:00",
"friday": "09:00–21:00",
"saturday": "10:00–21:00",
"sunday": "10:00–21:00"
}
| Name | Type | Description |
|---|---|---|
| monday | String | Range representation of opening hours for the day. |
upcoming
Contained once by openingHours element.
Contains upcoming opening hours for each day in day-named elements along with an element indicating when the new opening hours start. In the table below we only show <monday> since the same applies for other week days.
{
"monday": "08:30-18:30",
"tuesday": "08:30-18:30",
"wednesday": "08:30-18:30",
"thursday": "08:30-18:30",
"friday": "08:30-18:30",
"saturday": "08:30-14:00",
"sunday": "08:30-14:00",
"startDate": "2025-08-23"
}
| Name | Type | Description |
|---|---|---|
| monday | String | Range representation of opening hours for the day. |
| startDate | Date | The day on which the new opening hours come to effect. |
exceptions
Contained once by openingHours attribute.
exception
Contained none or many times by exceptions attribute.
This object is optional and exceptions attribute can be empty.
{
"exception": {
"date": "2025-12-30",
"hours": "08:00-12:00, 12:45-16:30"
}
}
| Name | Type | Description |
|---|---|---|
| date | Date | Date of the opening hours exception. |
| hours | String | Range representation of opening hours for the day. If omitted, the branch is closed on that day. |
extendedDelivery
Contained once by branch and box attribute.
{
"extendedDelivery": {
"saturday": "true"
}
}
| Name | Type | Description |
|---|---|---|
| saturday | Boolean | true or false. If true, then the Pick-up point / Z-BOX is available for Saturday delivery |
Boxes
[
{
"id": "18579",
"type": "zbox",
"name": "Z-BOX Praha 9, Libeň, Českomoravská 2408",
"place": "Z-BOX",
"street": "Českomoravská 2408",
"city": "Praha ",
"zip": "190 00",
"country": "cz",
"currency": "CZK",
"status": {
"statusId": "1",
"description": "In operation"
},
"codAllowed": "1",
"displayFrontend": "1",
"directions": "<p>Z-BOX je umístěn při vstupu do budovy Balabenka office z ulic Sokolovská a Na Rozcestí.</p>\n<p><strong>Dobré vědět:</strong></p>\n<p>Standardní úložní doba zásilek je 2 dny s možností prodloužení o další 1 den.</p>\n<p><strong>Co potřebujete k vyzvednutí zásilky?</strong></p>\n<p>Můžete si vybrat, jak zásilku ze Z-BOXu vyzvednete:</p>\n<ol>\n <li>\n Pomocí aktuální verze mobilní aplikace Zásilkovna\n <ul>\n <li>zapněte si Bluetooth a polohové služby</li>\n <li>ujistěte se, že v mobilní aplikaci i v objednávce zásilky máte uvedené stejné tel. číslo</li>\n </ul>\n </li>\n <li>Pomocí kódu, který vám pošleme do e-mailu, aplikace a případně SMS, jakmile bude zásilka připravena k vyzvednutí</li>\n</ol>\n<p>Vyzvedáváte zásilku na dobírku? Tu je potřeba uhradit předem přímo v aplikaci nebo přes odkaz na sledování zásilky, který najdete v e-mailu.</p>",
"directionsCar": {},
"directionsPublic": {},
"wheelchairAccessible": "no",
"creditCardPayment": "yes",
"dressingRoom": "0",
"claimAssistant": "0",
"packetConsignment": "1",
"latitude": "50.1048",
"longitude": "14.48353",
"url": "https://www.zasilkovna.cz/pobocky/praha-ceskomoravska-2408",
"maxWeight": "15",
"hasKeypad": "1",
"labelRouting": "C10-617-18579",
"labelName": "Z-BOX Praha 9, Libeň, Českomoravská 2408",
"photos": [
{
"thumbnail": "https://files.packeta.com/points/thumb/point_18579_4299c793b533.jpg",
"normal": "https://files.packeta.com/points/normal/point_18579_4299c793b533.jpg"
},
{
"thumbnail": "https://files.packeta.com/points/thumb/point_18579_50b43da18d7c.jpg",
"normal": "https://files.packeta.com/points/normal/point_18579_50b43da18d7c.jpg"
},
{
"thumbnail": "https://files.packeta.com/points/thumb/point_18579_be127e71ddb2.jpg",
"normal": "https://files.packeta.com/points/normal/point_18579_be127e71ddb2.jpg"
}
],
"openingHours": {
"regular": {
"monday": "00:00–23:59",
"tuesday": "00:00–23:59",
"wednesday": "00:00–23:59",
"thursday": "00:00–23:59",
"friday": "00:00–23:59",
"saturday": "00:00–23:59",
"sunday": "00:00–23:59"
},
"exceptions": {}
},
"extendedDelivery": {
"saturday": "true"
}
}
]
Z-BOX attributes
The box has same attributes as branch, plus the following:
| Name | Mandatory | Type | Description |
|---|---|---|---|
| type | Yes | String | Type of box. Current possible value: zbox |
| codAllowed | Yes | Integer | If 0 (zero) is marked, it is not possible to send a cash on delivery packet to this box. |
| hasKeypad | Yes | Integer | If 1 is marked, zbox contains keypad. Valid only for Z-BOX |
Carriers
[
{
"id": "1",
"name": "AT Austrian Post HD",
"available": "true",
"pickupPoints": "false",
"apiAllowed": "true",
"separateHouseNumber": "false",
"customsDeclarations": "false",
"requiresEmail": "true",
"requiresPhone": "true",
"requiresSize": "false",
"disallowsCod": "false",
"country": "at",
"currency": "EUR",
"maxWeight": "30",
"labelRouting": "C38-***-080",
"labelName": "AT Austrian Post HD"
}
]
carrier
Contained none or many times by carriers.
Represents a carrier.
| Name | Mandatory | Type | Description |
|---|---|---|---|
| id | Yes | Integer | A unique id. |
| name | Yes | String | Carrier name. |
| available | Yes | Boolean | Indicates whether the carrier is available for delivery. |
| pickupPoints | Yes | Boolean | Indicates whether the carrier offers its own pick-up points. Please refer to our carriers' PUDOs feed documentation for more information. |
| apiAllowed | Yes | Boolean | Indicates whether the carrier supports direct label printing, ie. whether the label is available via packetCourierLabelPdf(), packetCourierLabelPng() and packetsCourierLabelsPdf() methods. |
| separateHouseNumber | Yes | Boolean | Indicates whether the carrier requires a descriptive number to be entered in the houseNumber parameter. |
| customsDeclarations | Yes | Boolean | Indicates whether the carrier requires the completion of customs declarations in the CustomsDeclaration parameter - custom declarations documentation. |
| requiresEmail | Yes | Boolean | Indicates whether the carrier requires an email. |
| requiresPhone | Yes | Boolean | Indicates whether the carrier requires a phone number. |
| requiresSize | Yes | Boolean | Indicates whether the carrier requires size. |
| disallowsCod | Yes | Boolean | If true is marked, it is not possible to send a cash on delivery shipment through this carrier. |
| country | Yes | String | Country code. |
| currency | Yes | String | Currency code accepted by the carrier. |
| maxWeight | Yes | Integer | Maximal weight of the packet the carrier is able to handle. |
| labelRouting | No | String | Routing code of the carrier. Used for custom labels. |
| labelName | No | String | Carrier name for printing on custom labels. |