ConnectCloud Developers

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-After seconds (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:

{
  "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"}'

View as Markdown · Interactive reference · OpenAPI