{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/hermai/main/json-schema/hermai-brand-retrieve-request-schema.json",
  "title": "BrandRetrieveRequest",
  "x-generated": "2026-10-18",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/hermai-api-openapi.json#/components/schemas/BrandRetrieveRequest",
  "properties": {
    "domain": {
      "description": "Company domain to resolve. Exactly one of domain or email is required.",
      "type": "string"
    },
    "email": {
      "description": "Resolve the domain owning this email address instead. Exactly one of domain or email is required; a mailbox provider domain (gmail.com and similar) is rejected.",
      "type": "string"
    },
    "force_refresh": {
      "description": "Bypass the cache and force a fresh lookup. Requires a caller entitlement; rejected otherwise.",
      "type": "boolean"
    },
    "include_synthesized": {
      "description": "Include synthesized (best guess, non observed) fields in the response.",
      "type": "boolean"
    },
    "max_age_s": {
      "description": "Serve a cached result up to this many seconds old. Clamped to a plan dependent floor.",
      "type": "integer"
    },
    "wait_ms": {
      "description": "How long to wait synchronously for a cold lookup before returning a pending status.",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "type": "object"
}