Receive parcels in Germany via API

Give your agent or system a German delivery address. When a parcel arrives, we log it, photograph it, weigh it and send your webhook a JSON payload, usually within a few business hours.

Contact sales for API access€15 per parcel · volume pricing available

Endpoints

POST/expectedPre-announce a parcel by tracking number
GET/items?type=parcelList received parcels
GET/items/{id}Details, photos and storage status
POST/items/{id}/inspectOpen and photograph contents
POST/items/{id}/holdKeep in storage, don't auto-forward

Webhook: parcel.arrived

POST https://your-app.com/hooks/germanmailbox
X-GM-Signature: t=1791273600,v1=5f3c...

{
  "event": "parcel.arrived",
  "item": {
    "id": "itm_8f2k1x",
    "mailbox_id": "mbx_berlin_01",
    "carrier": "DHL",
    "tracking": "00340434161094042557",
    "reference": "order-4471",
    "weight_g": 1840,
    "dimensions_cm": [40, 30, 15],
    "photos": ["https://files.germanmailbox.com/itm_8f2k1x/1.jpg"]
  }
}

Beta: rough edges you should know about

Weight and dimensions are measured by hand and can be off by a few percent.
Parcels without a readable tracking label can't be matched automatically. They show up with reference: null.
Photo URLs expire after 7 days. Download them if you need to keep them.
Parcels arriving on weekends are logged on Monday.

API access is invite-only

We onboard API customers individually so we can set up your addresses, webhooks and volume pricing. Tell sales what you want to automate and we'll get you an API key.

Contact sales on WhatsApp API overview

Built for agents that buy things

If your AI agent orders from German shops like Amazon.de, Otto or Zalando, it needs a delivery address and a way to know the order arrived. Use the mailbox address as the shipping address, then match incoming parcels to orders by tracking number.

Pre-announce parcels

Tell us what you expect with POST /expected. When a parcel with that tracking number arrives, it is matched to your reference automatically. That means faster processing and fewer mix-ups.

Storage

Parcels are stored free for 30 days. After that, storage is charged per day. Ask sales for the current rate. You can query storage status per item.

Frequently asked questions

Do you sign for parcels?

Yes, we accept parcels from all major carriers (DHL, Hermes, DPD, GLS, UPS, FedEx), including ones that need a signature.

Can you open a parcel and check the contents?

Yes. POST /items/{id}/inspect has us open the parcel and photograph the contents. This costs extra, so ask sales for pricing.

Ready to go digital with your German mail?

Contact sales for API access

Need instructions? Contact support on WhatsApp. WhatsApp: +49 159 0104 5767