Ortwerk
returns rules
Text basis: BGB as published on gesetze-im-internet.de (retrieved 2026-11-01). Right of withdrawal for distance and off-premises contracts (§ 312g Abs. 1) unless one of the 13 exceptions of § 312g Abs. 2 applies. The 14-day period (§ 355 Abs. 2) starts with receipt of the goods (§ 356 Abs. 2 Nr. 1 a), of the last item or part delivery (b, c), of the first delivery for subscriptions (d), or with conclusion for services and digital content; not before compliant information (§ 356 Abs. 3). The.
POST https://ort.halowerk.com/v1/returns-rulesInputs
| Field | Type | Required | Description |
|---|---|---|---|
| contract_type | See schema | Yes | goods_separate_deliveries: several goods of one order delivered separately; goods_partial_shipments: one good in several parts; digital_content: not on a physical medium. |
| conclusion | See schema | No | |
| contract_date | string | Yes | |
| receipt_date | string | No | Date the consumer (or a named third person, not the carrier) received the goods – the last item/part, or the first item for subscriptions. |
| withdrawal_information | See schema | No | |
| information_date | string | No | Required when withdrawal_information is "later". |
| exception | See schema | No | § 312g Abs. 2 Nr. 1-13 if one applies. |
| withdrawal_sent_date | string | No | |
| withdrawal_received_date | string | No | |
| return_costs_informed | boolean | No | Consumer was informed that they bear the direct return costs. |
| trader_pays_return | boolean | No | |
| trader_offers_pickup | boolean | No | |
| consumer_state | See schema | No | German state of the consumer, for regional holidays under § 193. |
| online_interface | boolean | No | Contract concluded via an online user interface (§ 356a). |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"contract_type",
"contract_date"
],
"properties": {
"contract_type": {
"enum": [
"goods",
"goods_separate_deliveries",
"goods_partial_shipments",
"goods_subscription",
"services",
"digital_content"
],
"description": "goods_separate_deliveries: several goods of one order delivered separately; goods_partial_shipments: one good in several parts; digital_content: not on a physical medium."
},
"conclusion": {
"enum": [
"distance",
"off_premises"
],
"default": "distance"
},
"contract_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"receipt_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date the consumer (or a named third person, not the carrier) received the goods – the last item/part, or the first item for subscriptions."
},
"withdrawal_information": {
"enum": [
"at_conclusion",
"later",
"never"
],
"default": "at_conclusion"
},
"information_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Required when withdrawal_information is \"later\"."
},
"exception": {
"enum": [
"custom_made",
"perishable",
"sealed_hygiene_unsealed",
"inseparably_mixed",
"alcohol_market_price",
"sealed_media_unsealed",
"newspapers",
"financial_market",
"dated_leisure_service",
"public_auction",
"urgent_repairs",
"betting_lottery",
"notarised"
],
"description": "§ 312g Abs. 2 Nr. 1-13 if one applies."
},
"withdrawal_sent_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"withdrawal_received_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"return_costs_informed": {
"type": "boolean",
"default": true,
"description": "Consumer was informed that they bear the direct return costs."
},
"trader_pays_return": {
"type": "boolean",
"default": false
},
"trader_offers_pickup": {
"type": "boolean",
"default": false
},
"consumer_state": {
"enum": [
"BB",
"BE",
"BW",
"BY",
"HB",
"HE",
"HH",
"MV",
"NI",
"NW",
"RP",
"SH",
"SL",
"SN",
"ST",
"TH"
],
"description": "German state of the consumer, for regional holidays under § 193."
},
"online_interface": {
"type": "boolean",
"default": false,
"description": "Contract concluded via an online user interface (§ 356a)."
}
}
}Published input example
{
"contract_type": "goods",
"contract_date": "2026-10-30",
"receipt_date": "2026-11-02"
}Result & documentation
Machine-readable documentation of this hub
Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.
More endpoints in this hub
- Ortwerk0.01 USDC
area coverage
POSThttps://ort.halowerk.com/v1/area-coverageRuns one multi-source Dijkstra from all origins (Routing runs on HALOWERK's own graph of the German road and path network built from OpenStreetMap (Geofabrik germany-latest.osm.pbf, data until 2026-11-12, ODbL 1.0; 25 million nodes, edges a
- Ortwerk0.004 USDC
autobahn roadworks
POSThttps://ort.halowerk.com/v1/autobahn-roadworksFetches live roadworks (long- and short-term) and closures per motorway from the public Autobahn App API of Die Autobahn GmbH des Bundes (no key; https://verkehr.autobahn.de/o/autobahn). The free-text periods are parsed into concrete interv
- Ortwerk0.004 USDC
avalanche bulletin
POSThttps://ort.halowerk.com/v1/avalanche-bulletinFresh official WSL SLF CAAMLv6 JSON for one Swiss warning region, in de/en/fr/it with explicit actual-language fallback. Includes the complete unmodified bulletin, all elevation/aspect/time distinctions, publication and validity times, sour