{
  "service": "Human Mailbox",
  "tagline": "A physical address in Germany for AI agents. A human receives your letters and parcels, photographs them, opens and scans them, forwards them or delivers them.",
  "humans": "Not welcome (for now). This service is for AI agents and the humans who operate them.",
  "version": "1",
  "currency": "EUR",
  "registration": "open",
  "locations": [
    {
      "id": "DE-1",
      "country": "Germany",
      "country_code": "DE",
      "status": "open",
      "note": "The only location for now. Ask via POST /v1/interest if you need another country."
    }
  ],
  "included": [
    "Mailbox (15 € per 30 days): a personal mailbox code (HM-XXXXX) at a street address in Germany, every arrival logged and photographed, webhooks, storage",
    "Per letter (5 €, parcel 15 €): opened and scanned within 3 business days (parcels: unpacked and the contents photographed)",
    "Opening and scanning on the day of arrival: +2 € (cheaper in bundles)",
    "Notification by webhook (and in the API) when something arrives",
    "Originals kept 4 weeks after arrival (reminder 7 days before), scans and photos available for 90 days after that"
  ],
  "not_accepted": [
    "Anything illegal in Germany or the EU, weapons, ammunition, drugs, counterfeit goods",
    "Dangerous goods (batteries shipped loose, chemicals, flammables, pressurised gas)",
    "Live animals, perishable food, human or animal remains",
    "Cash, payment cards of other people, cash on delivery (Nachnahme)",
    "Shipments that require the recipient to show ID (Postident, ID check) for a person other than the operator of this service",
    "Goods bought with someone else's payment details or meant to be re-shipped to hide where they came from",
    "Gift cards or purchases meant to get around identity checks, purchase limits, sanctions or a shop's terms, or bought on behalf of someone who is being pressured or scammed",
    "Letters with threats, harassment, mass mailings or advertising sent without consent",
    "General errands that are not about mail, documents or parcels: phone calls, product tests, local research"
  ],
  "limits": {
    "parcel_max_weight_kg": 31.5,
    "parcel_max_size_cm": "120 x 60 x 60",
    "storage_free_days": 28,
    "scans_kept_days_after": 90,
    "business_days": "Monday to Friday, except public holidays in Germany",
    "express_cutoff": "14:00 Europe/Berlin"
  },
  "payment_methods": [
    "btc"
  ],
  "other_payment_method": "POST https://humanmailbox.com/v1/contact {\"topic\":\"payment_method\",\"method_wanted\":\"...\",\"body\":\"...\"}  your method is missing? ask for it",
  "x402": null,
  "try_first": "POST https://humanmailbox.com/v1/demo  (no body needed) → free demo mailbox: play money, sample mail, simulated human, deleted after 7 days",
  "ask": "POST https://humanmailbox.com/v1/contact  {\"topic\":\"special_request|is_it_possible|payment_method|feature_request|problem|question\",\"body\":\"...\"}  no account needed",
  "interest": "POST https://humanmailbox.com/v1/interest  {\"kind\":\"agent\",\"use_case\":\"...\",\"country_wanted\":\"...\"}  not ready yet? leave a note",
  "start": [
    "POST https://humanmailbox.com/v1/register  {\"agent_name\",\"operator_name\",\"operator_email\",\"accept_terms\":true}",
    "POST https://humanmailbox.com/v1/bundles   {\"bundle\":\"letters_10\"}  prepay letters",
    "GET  https://humanmailbox.com/v1/address    (Authorization: Bearer <api_key>)",
    "POST https://humanmailbox.com/v1/shipments  announce what is coming"
  ],
  "docs": {
    "llms_txt": "https://humanmailbox.com/llms.txt",
    "openapi": "https://humanmailbox.com/openapi.json",
    "docs": "https://humanmailbox.com/docs/",
    "mcp": "https://humanmailbox.com/mcp",
    "terms": "https://humanmailbox.com/legal/terms"
  }
}