Textwerk
objection draft
Computes the date of notification from posting or electronic dispatch with the four-day fiction (§ 122 Abs. 2, 2a AO; § 41 Abs. 2 VwVfG; § 37 Abs. 2 SGB X; one month for tax notices posted abroad) or from an actual receipt date, then the one-month objection period (§ 355 AO, § 70 VwGO, § 84 SGG; three months for SGG notices abroad) or one year without correct instructions on remedies (§ 356 Abs. 2 AO, § 58 Abs. 2 VwGO, § 66 Abs. 2 SGG), with § 188 Abs. 3 BGB for short months and the move to.
POST https://text.halowerk.com/v1/objection-draftInputs
| Field | Type | Required | Description |
|---|---|---|---|
| procedure | string | Yes | tax_ao: Einspruch against a tax notice; administrative_vwgo: Widerspruch against an administrative act; social_sgg: Widerspruch in social security matters. |
| notice | object | Yes | |
| delivery | object | Yes | |
| remedy_instructions | boolean | No | The notice contained correct instructions on remedies (Rechtsbehelfsbelehrung). |
| sender | object | Yes | |
| grounds | array | No | Your grounds; without grounds the letter announces that they will follow. |
| request_suspension | boolean | No | Add an application to suspend enforcement (§ 361 AO, § 80 Abs. 4 VwGO, § 86a Abs. 3 SGG). |
| letter_date | string | No | |
| place | string | No | |
| state | string | No | German federal state whose public holidays apply to the deadline (e.g. NW, BY). Without it only nationwide holidays are used. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"procedure",
"notice",
"delivery",
"sender"
],
"properties": {
"procedure": {
"type": "string",
"enum": [
"tax_ao",
"administrative_vwgo",
"social_sgg"
],
"description": "tax_ao: Einspruch against a tax notice; administrative_vwgo: Widerspruch against an administrative act; social_sgg: Widerspruch in social security matters."
},
"notice": {
"type": "object",
"additionalProperties": false,
"required": [
"authority",
"date",
"subject"
],
"properties": {
"authority": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"street",
"postcode",
"city"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Name or company."
},
"addition": {
"type": "string",
"maxLength": 120,
"description": "Optional second address line (department, c/o)."
},
"street": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Street and house number."
},
"postcode": {
"type": "string",
"pattern": "^[0-9A-Z -]{3,10}$",
"description": "Postcode."
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "City."
},
"country": {
"type": "string",
"maxLength": 60,
"description": "Country, only for addresses abroad."
}
}
},
"date": {
"type": "string",
"format": "date",
"description": "Date printed on the notice."
},
"subject": {
"type": "string",
"minLength": 3,
"maxLength": 200,
"description": "What the notice is about, e.g. \"Einkommensteuerbescheid 2025\"."
},
"reference": {
"type": "string",
"maxLength": 80,
"description": "File number, tax number or customer number."
}
}
},
"delivery": {
"type": "object",
"additionalProperties": false,
"required": [
"method"
],
"properties": {
"method": {
"type": "string",
"enum": [
"post",
"electronic",
"received"
],
"description": "post: posted by mail; electronic: sent electronically; received: actual receipt date known (e.g. personal delivery)."
},
"posted_date": {
"type": "string",
"format": "date",
"description": "post/electronic: day of posting or dispatch (usually the date on the notice)."
},
"received_date": {
"type": "string",
"format": "date",
"description": "received: day of actual receipt."
},
"abroad": {
"type": "boolean",
"default": false,
"description": "Notice delivered abroad."
}
}
},
"remedy_instructions": {
"type": "boolean",
"default": true,
"description": "The notice contained correct instructions on remedies (Rechtsbehelfsbelehrung)."
},
"sender": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"street",
"postcode",
"city"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Name or company."
},
"addition": {
"type": "string",
"maxLength": 120,
"description": "Optional second address line (department, c/o)."
},
"street": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Street and house number."
},
"postcode": {
"type": "string",
"pattern": "^[0-9A-Z -]{3,10}$",
"description": "Postcode."
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "City."
},
"country": {
"type": "string",
"maxLength": 60,
"description": "Country, only for addresses abroad."
}
}
},
"grounds": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"description": "Your grounds; without grounds the letter announces that they will follow."
},
"request_suspension": {
"type": "boolean",
"default": false,
"description": "Add an application to suspend enforcement (§ 361 AO, § 80 Abs. 4 VwGO, § 86a Abs. 3 SGG)."
},
"letter_date": {
"type": "string",
"format": "date"
},
"place": {
"type": "string",
"maxLength": 60
},
"state": {
"type": "string",
"enum": [
"BB",
"BE",
"BW",
"BY",
"HB",
"HE",
"HH",
"MV",
"NI",
"NW",
"RP",
"SH",
"SL",
"SN",
"ST",
"TH"
],
"description": "German federal state whose public holidays apply to the deadline (e.g. NW, BY). Without it only nationwide holidays are used."
}
}
}Published input example
{
"procedure": "tax_ao",
"notice": {
"authority": {
"name": "Finanzamt Ahaus",
"street": "Vredener Dyk 2",
"postcode": "48683",
"city": "Ahaus"
},
"date": "2026-10-23",
"subject": "Einkommensteuerbescheid 2025",
"reference": "301/5000/1234"
},
"delivery": {
"method": "post",
"posted_date": "2026-10-23"
},
"sender": {
"name": "Mietpartei Nord",
"street": "Hallenweg 1",
"postcode": "48599",
"city": "Gronau"
},
"state": "NW"
}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
- Textwerk0.002 USDC
acronym ideas
POSThttps://text.halowerk.com/v1/acronym-ideasSplits the title into words, marks German and English stop words (and, of, für, und ), and enumerates in word order every combination of the first 1-3 letters of each significant word (stop words contribute 0 or 1 letter when allowed), with
- Textwerk0.005 USDC
agg check
POSThttps://text.halowerk.com/v1/agg-checkApplies documented rules to the ad text and its first line or title: explicit age limits and age ranges, youth-related team wording and career-stage target groups (age); native-speaker, accent and origin requirements, nationality (ethnic or
- Textwerk0.002 USDC
anglicism replace
POSThttps://text.halowerk.com/v1/anglicism-replaceLooks up every word in about 1,050 entries that OpenThesaurus (export 2026-10-30, LGPL-2.1 or CC BY-SA 4.0) labels English, Anglicism or Denglisch, matching inflected forms from german-pos-dict 1.2.2 (CC BY-SA 4.0) and English heads of comp