Pickups
Courier pickup hours and pickup ordering.
Pickup hours
Returns available courier pickup hours for a postal code and service.
hours is keyed by date (pass remove_index: true for a plain
array).
Pickup hours › Request Body
app_idApplication ID issued in the Apaczka panel (API settings).
expiresUnix timestamp until which the request is valid. At most 15 minutes
in the future (the Postman collection uses now + 900 s).
signature^[0-9a-f]{64}$ · requiredLowercase-hex HMAC-SHA256 of
app_id + ":" + route + ":" + request + ":" + expires keyed with
your app_secret, where route is the method path including path
parameters and trailing slash (e.g. order_send/,
waybill/123456/).
Pickup hours › Responses
Always HTTP 200 — check status in the body for the real outcome.
statusApplication-level status — 200 means success, anything else is an error code.
messageHuman-readable error message (empty on success).
Method-specific result. null on failure.
Order courier pickup (existing order)
Re-orders a courier pickup for an already created order. The signed
route is pickup/<order_id>/.
Constraints (from the current implementation): available only for DPD orders, and the account needs the pickup via API privilege. See the Pickup types guide.
path Parameters
order_idApaczka order ID (part of the signed route).
Order courier pickup (existing order) › Request Body
app_idApplication ID issued in the Apaczka panel (API settings).
expiresUnix timestamp until which the request is valid. At most 15 minutes
in the future (the Postman collection uses now + 900 s).
signature^[0-9a-f]{64}$ · requiredLowercase-hex HMAC-SHA256 of
app_id + ":" + route + ":" + request + ":" + expires keyed with
your app_secret, where route is the method path including path
parameters and trailing slash (e.g. order_send/,
waybill/123456/).
Order courier pickup (existing order) › Responses
Always HTTP 200 — check status in the body for the real outcome.
statusApplication-level status — 200 means success, anything else is an error code.
messageHuman-readable error message (empty on success).
Method-specific result. null on failure.
Batch courier pickup
Orders one courier pickup for multiple existing orders at once.
Constraints (from the current implementation): all orders must share the same sender address and service, the service must support batch pickup, and the account needs the pickup via API privilege. See the Pickup types guide.
Batch courier pickup › Request Body
app_idApplication ID issued in the Apaczka panel (API settings).
expiresUnix timestamp until which the request is valid. At most 15 minutes
in the future (the Postman collection uses now + 900 s).
signature^[0-9a-f]{64}$ · requiredLowercase-hex HMAC-SHA256 of
app_id + ":" + route + ":" + request + ":" + expires keyed with
your app_secret, where route is the method path including path
parameters and trailing slash (e.g. order_send/,
waybill/123456/).
Batch courier pickup › Responses
Always HTTP 200 — check status in the body for the real outcome.
statusApplication-level status — 200 means success, anything else is an error code.
messageHuman-readable error message (empty on success).
Method-specific result. null on failure.