Přeskočit na hlavní obsah
For any questions, feel free to contact our integrations team at integrations@packeta.com

Packeta PUDOs

The endpoints below refer to the __API_KEY__. You can locate it in the client section under the User Support category.

Update frequency

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 optimization

    Request 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.

NameDescription
langFilter by language. Two-letter ISO 639-1 format country code. en, cs, sk are supported.
countryFilter 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.

CodeStatusDescription
200OK
401UnauthorizedIncorrect credentials
404Not found
409ConflictThe feed generation was executed from another request and its still running. Try request later.
415Unsupported Media TypeRequested 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​

NameMandatoryTypeDescription
idYesIntegerA unique id.
nameYesStringBranch name.
specialNoStringSpecial orientation feature of the location.
placeYesStringName of the place hosting the branch i.e. Baker & Sons bakery.
streetYesStringStreet name and number.
cityYesStringCity.
zipYesStringZip code. Contains spaces based on standard country format.
countryYesStringCountry code.
currencyYesStringCurrency code accepted by the branch.
statusYesObjectContainer for the status code and status message of the branch. See status.
displayFrontendYesIntegerIndicates 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.
exportedUntilNoDateIf 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.
enterableUntilNoDateIf 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.
openUntilNoDateIf 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.
openSinceNoDateIf 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.
directionsNoStringHTML directions to the branch. If empty, it is an object.
directionsCarNoStringHTML directions to the branch when travelling by car.
directionsPublicNoStringHTML directions to the branch when travelling via public transport.
wheelchairAccessibleYesStringIndicates whether the branch is wheelchair accessible.
creditCardPaymentYesStringIndicates whether the branch accepts credit card as payment option.
dressingRoomYesIntegerIndicates whether the branch has a dressing room.
claimAssistantYesIntegerIndicates whether the branch accepts Claim Assistant packets.
packetConsignmentYesIntegerIndicates whether the branch accepts packet consignment.
latitudeYesDecimalLatitude.
longitudeYesDecimalLongitude.
urlYesStringURL with branch information.
maxWeightYesIntegerMaximal weight of the packet the branch is able to handle.
holidayStartNoDateThe 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.
holidayEndNoDateThe date of the end of the holiday.
labelRoutingNoStringRouting code of the branch. Used for custom labels.
labelNameNoStringBranch name for printing on custom labels.
photosYesObjectContainer for photo elements.
openingHoursYesObjectContainer for opening hours information. See openingHours documentation.
extendedDeliveryYesObjectContainer 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"
}
NameTypeDescription
statusIdIntegerNumeric code of branch status.
descriptionStringText message of the branch status in chosen language.

List of statuses

Status codeDescription
1In operation.
2Temporarily does not receive packets due to exceeded capacity.
3Temporarily closed due to holiday.
4Temporarily does not receive packets due to technical reasons.
5The 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"
}
NameTypeDescription
thumbnailStringURL of a thumbnail image 160px*120px.
normalStringURL 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"
}
]
}
NameTypeDescription
regularObjectContainer for opening hours by day. See documentation for regular element.
upcomingObjectContainer for upcoming opening hours by day. See documentation for upcoming element.
exceptionsObjectContainer 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"
}
NameTypeDescription
mondayStringRange 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"
}
NameTypeDescription
mondayStringRange representation of opening hours for the day.
startDateDateThe 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"
}
}
NameTypeDescription
dateDateDate of the opening hours exception.
hoursStringRange 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"
}
}
NameTypeDescription
saturdayBooleantrue 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:

NameMandatoryTypeDescription
typeYesStringType of box. Current possible value: zbox
codAllowedYesIntegerIf 0 (zero) is marked, it is not possible to send a cash on delivery packet to this box.
hasKeypadYesIntegerIf 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.

NameMandatoryTypeDescription
idYesIntegerA unique id.
nameYesStringCarrier name.
availableYesBooleanIndicates whether the carrier is available for delivery.
pickupPointsYesBooleanIndicates whether the carrier offers its own pick-up points. Please refer to our carriers' PUDOs feed documentation for more information.
apiAllowedYesBooleanIndicates whether the carrier supports direct label printing, ie. whether the label is available via packetCourierLabelPdf(), packetCourierLabelPng() and packetsCourierLabelsPdf() methods.
separateHouseNumberYesBooleanIndicates whether the carrier requires a descriptive number to be entered in the houseNumber parameter.
customsDeclarationsYesBooleanIndicates whether the carrier requires the completion of customs declarations in the CustomsDeclaration parameter - custom declarations documentation.
requiresEmailYesBooleanIndicates whether the carrier requires an email.
requiresPhoneYesBooleanIndicates whether the carrier requires a phone number.
requiresSizeYesBooleanIndicates whether the carrier requires size.
disallowsCodYesBooleanIf true is marked, it is not possible to send a cash on delivery shipment through this carrier.
countryYesStringCountry code.
currencyYesStringCurrency code accepted by the carrier.
maxWeightYesIntegerMaximal weight of the packet the carrier is able to handle.
labelRoutingNoStringRouting code of the carrier. Used for custom labels.
labelNameNoStringCarrier name for printing on custom labels.