brands

{'type': 'object', 'required': ['id_or_alias'], 'properties': {'id_or_alias': {'type': 'string', 'description': "Brand numeric ID, slug or alias, e.g. 'deuter' or '16709'."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'name', 'slug', 'website_url', 'logo', 'categories', 'retailer_count', 'product_count', 'details'], 'properties': {'id': {'type': 'integer', 'description': 'Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.'}, 'logo': {'type': ['string', 'null'], 'description': 'Logo image URL, or null.'}, 'name': {'type': ['string', 'null'], 'description': 'Display name.'}, 'slug': {'type': ['string', 'null'], 'description': 'URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.'}, 'details': {'type': ['object', 'null'], 'required': ['description', 'hq_country', 'registration_date', 'social'], 'properties': {'social': {'type': ['object', 'null'], 'required': ['instagram', 'facebook', 'linkedin', 'youtube'], 'properties': {'youtube': {'type': ['string', 'null']}, 'facebook': {'type': ['string', 'null']}, 'linkedin': {'type': ['string', 'null']}, 'instagram': {'type': ['string', 'null']}}, 'description': 'Social media profile URLs; each may be null.', 'additionalProperties': False}, 'hq_country': {'type': ['string', 'null'], 'description': 'Headquarters country code, or null.'}, 'description': {'type': ['object', 'null'], 'required': ['de', 'en'], 'properties': {'de': {'type': ['string', 'null'], 'description': 'German text, or null.'}, 'en': {'type': ['string', 'null'], 'description': 'English text, or null.'}}, 'description': 'Description text in German (de) and English (en); each may be null.', 'additionalProperties': False}, 'registration_date': {'type': ['string', 'null'], 'description': 'Date (YYYY-MM-DD) the company registered on authorized.by.'}}, 'description': 'Extended profile details.', 'additionalProperties': False}, 'categories': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['id', 'name_de', 'name_en'], 'properties': {'id': {'type': 'integer', 'description': 'Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.'}, 'name_de': {'type': ['string', 'null'], 'description': 'German category name.'}, 'name_en': {'type': ['string', 'null'], 'description': 'English category name.'}}, 'additionalProperties': False}, 'description': 'Product categories.'}, 'website_url': {'type': ['string', 'null'], 'description': 'Brand website URL, or null.'}, 'product_count': {'type': 'integer', 'description': 'Number of products registered on authorized.by; null when unknown.'}, 'retailer_count': {'type': 'integer', 'description': 'Number of retailers currently authorized by this brand on authorized.by.'}}, 'description': 'The public profile of one brand.', 'additionalProperties': False}

{'type': 'object', 'required': ['id_or_alias'], 'properties': {'id_or_alias': {'type': 'string', 'description': 'Brand numeric ID, slug or alias.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['brand_id', 'total', 'premium_count', 'tuv_certified_count', 'retailers'], 'properties': {'total': {'type': 'integer', 'description': 'Number of entries in the list.'}, 'brand_id': {'type': 'integer', 'description': 'Numeric ID of the brand the list belongs to.'}, 'retailers': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['id', 'name', 'slug', 'shop_url', 'logo', 'plan', 'tuv_certified', 'seal_implemented', 'official_shop', 'sponsored', 'certificate_url', 'certificate_url_de', 'brand_count', 'product_count', 'partnership_date', 'details'], 'properties': {'id': {'type': 'integer', 'description': 'Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.'}, 'logo': {'type': ['string', 'null'], 'description': 'Logo image URL, or null.'}, 'name': {'type': ['string', 'null'], 'description': 'Display name.'}, 'plan': {'type': ['string', 'null'], 'description': 'authorized.by subscription plan of the retailer: PREMIUM, START or FREE.'}, 'slug': {'type': ['string', 'null'], 'description': 'URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.'}, 'details': {'type': ['object', 'null'], 'required': ['address', 'phone', 'email', 'opening_hours', 'payment_methods', 'description', 'categories', 'tuv_certification_date', 'registration_date', 'trustami', 'social'], 'properties': {'email': {'type': ['string', 'null']}, 'phone': {'type': ['string', 'null']}, 'social': {'type': ['object', 'null'], 'required': ['instagram', 'facebook', 'linkedin', 'youtube'], 'properties': {'youtube': {'type': ['string', 'null']}, 'facebook': {'type': ['string', 'null']}, 'linkedin': {'type': ['string', 'null']}, 'instagram': {'type': ['string', 'null']}}, 'description': 'Social media profile URLs; each may be null.', 'additionalProperties': False}, 'address': {'type': ['string', 'null']}, 'trustami': {'type': ['object', 'null'], 'required': ['rating', 'review_count', 'profile_url'], 'properties': {'rating': {'type': ['number', 'null'], 'description': 'Average customer rating, or null.'}, 'profile_url': {'type': ['string', 'null'], 'description': 'URL of the rating profile, or null.'}, 'review_count': {'type': ['integer', 'null'], 'description': 'Number of customer reviews, or null.'}}, 'description': 'Customer rating from Trustami; fields are null when no rating exists.', 'additionalProperties': False}, 'categories': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['de', 'en'], 'properties': {'de': {'type': ['string', 'null'], 'description': 'German text, or null.'}, 'en': {'type': ['string', 'null'], 'description': 'English text, or null.'}}, 'additionalProperties': False}, 'description': 'Product categories.'}, 'description': {'type': ['object', 'null'], 'required': ['de', 'en'], 'properties': {'de': {'type': ['string', 'null'], 'description': 'German text, or null.'}, 'en': {'type': ['string', 'null'], 'description': 'English text, or null.'}}, 'description': 'Description text in German (de) and English (en); each may be null.', 'additionalProperties': False}, 'opening_hours': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['day_of_week', 'opening_hour', 'closing_hour'], 'properties': {'day_of_week': {'type': ['string', 'null'], 'description': 'Day of the week.'}, 'closing_hour': {'type': ['string', 'null'], 'description': 'Closing time.'}, 'opening_hour': {'type': ['string', 'null'], 'description': 'Opening time.'}}, 'additionalProperties': False}, 'description': 'Weekly opening hours of the physical store; empty or null when unknown.'}, 'payment_methods': {'type': ['array', 'null'], 'items': {'type': 'string'}, 'description': 'Accepted payment methods; null when unknown.'}, 'registration_date': {'type': ['string', 'null'], 'description': 'Date (YYYY-MM-DD) the company registered on authorized.by.'}, 'tuv_certification_date': {'type': ['string', 'null'], 'description': 'Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified.'}}, 'description': 'Extended profile details.', 'additionalProperties': False}, 'shop_url': {'type': ['string', 'null'], 'description': 'Retailer online-shop URL, or null.'}, 'sponsored': {'type': 'boolean', 'description': 'Whether the brand sponsors (highlights) this retailer.'}, 'brand_count': {'type': 'integer', 'description': 'Number of brands that currently authorize this retailer on authorized.by.'}, 'official_shop': {'type': 'boolean', 'description': "Whether this shop is the brand's own official shop."}, 'product_count': {'type': ['integer', 'null'], 'description': 'Number of products registered on authorized.by; null when unknown.'}, 'tuv_certified': {'type': 'boolean', 'description': 'Whether the retailer holds a TÜV certification via authorized.by.'}, 'certificate_url': {'type': ['string', 'null'], 'description': 'Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization.'}, 'partnership_date': {'type': ['string', 'null'], 'description': 'Date (YYYY-MM-DD) the authorization STARTED. Not a last-verified date: every listed partnership is active as of the response.'}, 'seal_implemented': {'type': 'boolean', 'description': "Whether the authorized.by seal is live on the retailer's shop."}, 'certificate_url_de': {'type': ['string', 'null'], 'description': 'Same certificate page in German; null when there is no active authorization.'}}, 'additionalProperties': False}}, 'premium_count': {'type': 'integer', 'description': 'Number of listed retailers on the PREMIUM plan.'}, 'tuv_certified_count': {'type': 'integer', 'description': 'Number of listed retailers with a TÜV certification.'}}, 'description': 'All retailers currently authorized by the brand, with per-retailer certificate links.', 'additionalProperties': False}

{'type': 'object', 'properties': {'page': {'type': 'integer', 'description': 'Zero-based page number (default 0).'}, 'size': {'type': 'integer', 'description': 'Page size (default 500).'}, 'search': {'type': 'string', 'description': 'Filter by brand name or alias. Optional.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['brands', 'meta', 'pagination'], 'properties': {'meta': {'type': ['object', 'null'], 'required': ['total_brands', 'total_retailers', 'total_connections', 'generated_at'], 'properties': {'generated_at': {'type': ['string', 'null'], 'description': 'Timestamp (ISO 8601) the index was generated.'}, 'total_brands': {'type': 'integer', 'description': 'Total number of public brands on authorized.by.'}, 'total_retailers': {'type': 'integer', 'description': 'Total number of public retailers on authorized.by.'}, 'total_connections': {'type': 'integer', 'description': 'Total number of active brand-retailer authorizations on authorized.by.'}}, 'description': 'Network-wide totals.', 'additionalProperties': False}, 'brands': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['id', 'name', 'slug', 'logo', 'retailer_count'], 'properties': {'id': {'type': 'integer', 'description': 'Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.'}, 'logo': {'type': ['string', 'null'], 'description': 'Logo image URL, or null.'}, 'name': {'type': ['string', 'null'], 'description': 'Display name.'}, 'slug': {'type': ['string', 'null'], 'description': 'URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.'}, 'retailer_count': {'type': 'integer', 'description': 'Number of retailers currently authorized by this brand on authorized.by.'}}, 'additionalProperties': False}}, 'pagination': {'type': ['object', 'null'], 'required': ['page', 'size', 'total_items', 'total_pages'], 'properties': {'page': {'type': 'integer', 'description': 'Zero-based page number of this response.'}, 'size': {'type': 'integer', 'description': 'Page size used for this response.'}, 'total_items': {'type': 'integer', 'description': 'Total number of matching entries across all pages.'}, 'total_pages': {'type': 'integer', 'description': 'Total number of pages.'}}, 'description': 'Pagination of this response.', 'additionalProperties': False}}, 'description': 'A page of brands plus network-wide totals and pagination.', 'additionalProperties': False}

{'type': 'object', 'required': ['id_or_alias'], 'properties': {'id_or_alias': {'type': 'string', 'description': 'Retailer numeric ID, slug or alias.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'name', 'slug', 'shop_url', 'logo', 'certificate_url', 'certificate_url_de', 'plan', 'tuv_certified', 'seal_implemented', 'brand_count', 'details'], 'properties': {'id': {'type': 'integer', 'description': 'Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.'}, 'logo': {'type': ['string', 'null'], 'description': 'Logo image URL, or null.'}, 'name': {'type': ['string', 'null'], 'description': 'Display name.'}, 'plan': {'type': ['string', 'null'], 'description': 'authorized.by subscription plan of the retailer: PREMIUM, START or FREE.'}, 'slug': {'type': ['string', 'null'], 'description': 'URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.'}, 'details': {'type': ['object', 'null'], 'required': ['address', 'phone', 'email', 'opening_hours', 'payment_methods', 'description', 'categories', 'tuv_certification_date', 'registration_date', 'trustami', 'social'], 'properties': {'email': {'type': ['string', 'null']}, 'phone': {'type': ['string', 'null']}, 'social': {'type': ['object', 'null'], 'required': ['instagram', 'facebook', 'linkedin', 'youtube'], 'properties': {'youtube': {'type': ['string', 'null']}, 'facebook': {'type': ['string', 'null']}, 'linkedin': {'type': ['string', 'null']}, 'instagram': {'type': ['string', 'null']}}, 'description': 'Social media profile URLs; each may be null.', 'additionalProperties': False}, 'address': {'type': ['string', 'null']}, 'trustami': {'type': ['object', 'null'], 'required': ['rating', 'review_count', 'profile_url'], 'properties': {'rating': {'type': ['number', 'null'], 'description': 'Average customer rating, or null.'}, 'profile_url': {'type': ['string', 'null'], 'description': 'URL of the rating profile, or null.'}, 'review_count': {'type': ['integer', 'null'], 'description': 'Number of customer reviews, or null.'}}, 'description': 'Customer rating from Trustami; fields are null when no rating exists.', 'additionalProperties': False}, 'categories': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['de', 'en'], 'properties': {'de': {'type': ['string', 'null'], 'description': 'German text, or null.'}, 'en': {'type': ['string', 'null'], 'description': 'English text, or null.'}}, 'additionalProperties': False}, 'description': 'Product categories.'}, 'description': {'type': ['object', 'null'], 'required': ['de', 'en'], 'properties': {'de': {'type': ['string', 'null'], 'description': 'German text, or null.'}, 'en': {'type': ['string', 'null'], 'description': 'English text, or null.'}}, 'description': 'Description text in German (de) and English (en); each may be null.', 'additionalProperties': False}, 'opening_hours': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['day_of_week', 'opening_hour', 'closing_hour'], 'properties': {'day_of_week': {'type': ['string', 'null'], 'description': 'Day of the week.'}, 'closing_hour': {'type': ['string', 'null'], 'description': 'Closing time.'}, 'opening_hour': {'type': ['string', 'null'], 'description': 'Opening time.'}}, 'additionalProperties': False}, 'description': 'Weekly opening hours of the physical store; empty or null when unknown.'}, 'payment_methods': {'type': ['array', 'null'], 'items': {'type': 'string'}, 'description': 'Accepted payment methods; null when unknown.'}, 'registration_date': {'type': ['string', 'null'], 'description': 'Date (YYYY-MM-DD) the company registered on authorized.by.'}, 'tuv_certification_date': {'type': ['string', 'null'], 'description': 'Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified.'}}, 'description': 'Extended profile details.', 'additionalProperties': False}, 'shop_url': {'type': ['string', 'null'], 'description': 'Retailer online-shop URL, or null.'}, 'brand_count': {'type': 'integer', 'description': 'Number of brands that currently authorize this retailer on authorized.by.'}, 'tuv_certified': {'type': 'boolean', 'description': 'Whether the retailer holds a TÜV certification via authorized.by.'}, 'certificate_url': {'type': ['string', 'null'], 'description': 'Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization.'}, 'seal_implemented': {'type': 'boolean', 'description': "Whether the authorized.by seal is live on the retailer's shop."}, 'certificate_url_de': {'type': ['string', 'null'], 'description': 'Same certificate page in German; null when there is no active authorization.'}}, 'description': 'The public profile of one retailer.', 'additionalProperties': False}

{'type': 'object', 'required': ['id_or_alias'], 'properties': {'id_or_alias': {'type': 'string', 'description': 'Retailer numeric ID, slug or alias.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['retailer_id', 'total', 'brands'], 'properties': {'total': {'type': 'integer', 'description': 'Number of entries in the list.'}, 'brands': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['id', 'name', 'slug', 'website_url', 'logo', 'official_shop', 'certificate_url', 'certificate_url_de', 'partnership_date'], 'properties': {'id': {'type': 'integer', 'description': 'Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.'}, 'logo': {'type': ['string', 'null'], 'description': 'Logo image URL, or null.'}, 'name': {'type': ['string', 'null'], 'description': 'Display name.'}, 'slug': {'type': ['string', 'null'], 'description': 'URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.'}, 'website_url': {'type': ['string', 'null'], 'description': 'Brand website URL, or null.'}, 'official_shop': {'type': 'boolean', 'description': "Whether this shop is the brand's own official shop."}, 'certificate_url': {'type': ['string', 'null'], 'description': 'Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization.'}, 'partnership_date': {'type': ['string', 'null'], 'description': 'Date (YYYY-MM-DD) the authorization STARTED. Not a last-verified date: every listed partnership is active as of the response.'}, 'certificate_url_de': {'type': ['string', 'null'], 'description': 'Same certificate page in German; null when there is no active authorization.'}}, 'additionalProperties': False}}, 'retailer_id': {'type': 'integer', 'description': 'Numeric ID of the retailer the list belongs to.'}}, 'description': 'All brands that currently authorize the retailer, with per-brand certificate links.', 'additionalProperties': False}

{'type': 'object', 'properties': {'page': {'type': 'integer', 'description': 'Zero-based page number (default 0).'}, 'size': {'type': 'integer', 'description': 'Page size (default 500).'}, 'search': {'type': 'string', 'description': 'Filter by retailer company name or alias. Optional.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['retailers', 'meta', 'pagination'], 'properties': {'meta': {'type': ['object', 'null'], 'required': ['total_brands', 'total_retailers', 'total_connections', 'generated_at'], 'properties': {'generated_at': {'type': ['string', 'null'], 'description': 'Timestamp (ISO 8601) the index was generated.'}, 'total_brands': {'type': 'integer', 'description': 'Total number of public brands on authorized.by.'}, 'total_retailers': {'type': 'integer', 'description': 'Total number of public retailers on authorized.by.'}, 'total_connections': {'type': 'integer', 'description': 'Total number of active brand-retailer authorizations on authorized.by.'}}, 'description': 'Network-wide totals.', 'additionalProperties': False}, 'retailers': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['id', 'name', 'slug', 'shop_url', 'logo', 'seal_implemented', 'brand_count', 'details'], 'properties': {'id': {'type': 'integer', 'description': 'Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.'}, 'logo': {'type': ['string', 'null'], 'description': 'Logo image URL, or null.'}, 'name': {'type': ['string', 'null'], 'description': 'Display name.'}, 'slug': {'type': ['string', 'null'], 'description': 'URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.'}, 'details': {'type': ['object', 'null'], 'required': ['address', 'phone', 'email', 'opening_hours', 'payment_methods', 'description', 'categories', 'tuv_certification_date', 'registration_date', 'trustami', 'social'], 'properties': {'email': {'type': ['string', 'null']}, 'phone': {'type': ['string', 'null']}, 'social': {'type': ['object', 'null'], 'required': ['instagram', 'facebook', 'linkedin', 'youtube'], 'properties': {'youtube': {'type': ['string', 'null']}, 'facebook': {'type': ['string', 'null']}, 'linkedin': {'type': ['string', 'null']}, 'instagram': {'type': ['string', 'null']}}, 'description': 'Social media profile URLs; each may be null.', 'additionalProperties': False}, 'address': {'type': ['string', 'null']}, 'trustami': {'type': ['object', 'null'], 'required': ['rating', 'review_count', 'profile_url'], 'properties': {'rating': {'type': ['number', 'null'], 'description': 'Average customer rating, or null.'}, 'profile_url': {'type': ['string', 'null'], 'description': 'URL of the rating profile, or null.'}, 'review_count': {'type': ['integer', 'null'], 'description': 'Number of customer reviews, or null.'}}, 'description': 'Customer rating from Trustami; fields are null when no rating exists.', 'additionalProperties': False}, 'categories': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['de', 'en'], 'properties': {'de': {'type': ['string', 'null'], 'description': 'German text, or null.'}, 'en': {'type': ['string', 'null'], 'description': 'English text, or null.'}}, 'additionalProperties': False}, 'description': 'Product categories.'}, 'description': {'type': ['object', 'null'], 'required': ['de', 'en'], 'properties': {'de': {'type': ['string', 'null'], 'description': 'German text, or null.'}, 'en': {'type': ['string', 'null'], 'description': 'English text, or null.'}}, 'description': 'Description text in German (de) and English (en); each may be null.', 'additionalProperties': False}, 'opening_hours': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['day_of_week', 'opening_hour', 'closing_hour'], 'properties': {'day_of_week': {'type': ['string', 'null'], 'description': 'Day of the week.'}, 'closing_hour': {'type': ['string', 'null'], 'description': 'Closing time.'}, 'opening_hour': {'type': ['string', 'null'], 'description': 'Opening time.'}}, 'additionalProperties': False}, 'description': 'Weekly opening hours of the physical store; empty or null when unknown.'}, 'payment_methods': {'type': ['array', 'null'], 'items': {'type': 'string'}, 'description': 'Accepted payment methods; null when unknown.'}, 'registration_date': {'type': ['string', 'null'], 'description': 'Date (YYYY-MM-DD) the company registered on authorized.by.'}, 'tuv_certification_date': {'type': ['string', 'null'], 'description': 'Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified.'}}, 'description': 'Extended profile details.', 'additionalProperties': False}, 'shop_url': {'type': ['string', 'null'], 'description': 'Retailer online-shop URL, or null.'}, 'brand_count': {'type': 'integer', 'description': 'Number of brands that currently authorize this retailer on authorized.by.'}, 'seal_implemented': {'type': 'boolean', 'description': "Whether the authorized.by seal is live on the retailer's shop."}}, 'additionalProperties': False}}, 'pagination': {'type': ['object', 'null'], 'required': ['page', 'size', 'total_items', 'total_pages'], 'properties': {'page': {'type': 'integer', 'description': 'Zero-based page number of this response.'}, 'size': {'type': 'integer', 'description': 'Page size used for this response.'}, 'total_items': {'type': 'integer', 'description': 'Total number of matching entries across all pages.'}, 'total_pages': {'type': 'integer', 'description': 'Total number of pages.'}}, 'description': 'Pagination of this response.', 'additionalProperties': False}}, 'description': 'A page of retailers plus network-wide totals and pagination.', 'additionalProperties': False}