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:
{
"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-Afterseconds (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 readcity(string): CitycompanyName(string): Company nameemail(string): E-mail addresslegalForm(string): Legal formphone(string): Phone numberregisterCourt(string): Register courtregisterNo(string): Commercial register numberstreet(string): Street with house numbervatId(string): VAT IDzip(string): Postal code
Example 200 answer:
{
"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
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"}'