## Read the imprint of a website (tenant:masterdata:read)

`POST /api/masterdata/imprint:lookup`

Module: Master data · operationId: `lookupImprint` · Tag: Drafts · Auth: access token (`Authorization: Bearer <accessToken>`)

Fetches and parses a German imprint (Impressum). A URL with a path is read as given; a
homepage, a domain or an email address starts the discovery (homepage → imprint link →
`/impressum`, `/imprint`). Only public web addresses are fetched. Free-mail domains answer
`422` (`free_mail_domain`), invalid or disallowed targets `400` (`invalid`),
unreachable sites or timeouts `502` (`unavailable`).

### Request body

`application/json` (required)

- `domain` (string): Domain whose website is searched for an imprint (max length 255)
- `email` (string): E-mail address whose domain is looked up (max length 320)
- `url` (string): Imprint URL (read as given) or homepage (max length 2048)

Example:

```json
{
  "domain": "muster.de"
}
```

### Responses

- **200** The parsed imprint (`application/json`)
- **400** Malformed body or query parameter (`application/json`)
- **401** Missing, invalid or expired token (empty body)
- **403** The token lacks the permission or carries no tenant (`application/json`)
- **429** Too many AI drafts or imprint lookups of this person – wait `Retry-After` seconds ([rate limits](/guides/rate-limits)) (`application/json`)
- **502** The website could not be read (`application/json`)

Fields of the 200 answer:

- `managingDirectors` (array of string, required): Managing directors (empty when none were found)
- `url` (string, required): The page that was read
- `city` (string): City
- `companyName` (string): Company name
- `email` (string): E-mail address
- `legalForm` (string): Legal form
- `phone` (string): Phone number
- `registerCourt` (string): Register court
- `registerNo` (string): Commercial register number
- `street` (string): Street with house number
- `vatId` (string): VAT ID
- `zip` (string): Postal code

Example 200 answer:

```json
{
  "city": "Bodenmais",
  "companyName": "Hotel Waldblick Bodenmais GmbH",
  "email": "info@hotel-waldblick.example",
  "legalForm": "GmbH",
  "managingDirectors": [
    "Markus Pongratz"
  ],
  "phone": "+49 9924 77810",
  "registerCourt": "Amtsgericht Deggendorf",
  "registerNo": "HRB 9876",
  "street": "Waldweg 7",
  "url": "https://www.hotel-waldblick.example/impressum",
  "zip": "94249"
}
```

### Example request

```bash
curl -X POST 'https://api.mbcom.cloud/api/masterdata/imprint:lookup' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"domain":"muster.de"}'
```
