Server definition
- Hash
- sha256:f6fd31611133f4b15607a7c2b0070a4571908588efa98d5bdcb460c4ba0c45dd
- What it is
- What a remote MCP server returned when asked what it offers: 6 tools
The blob, as servednamed by its sha256
{
"instructions": "authorized.by is the registry of retailers that brands (manufacturers) have explicitly authorized to sell their products. All tools are read-only. Typical flow: resolve a name with get_brands or get_retailers, then call get_brand_retailers (brand → authorized shops) or get_retailer_brands (shop → authorized brands). Results only cover authorizations registered and confirmed on authorized.by; a missing record does not prove that no authorization exists elsewhere. certificate_url fields link to public proof pages.",
"tools": [
{
"description": "Get the public profile of one brand (manufacturer) on authorized.by. Read-only. Returns categories, website, headquarters country, description, registration date and the number of authorized retailers. Use get_brands first if you only know an approximate name. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id_or_alias": {
"description": "Brand numeric ID, slug or alias, e.g. 'deuter' or '16709'.",
"type": "string"
}
},
"required": [
"id_or_alias"
],
"type": "object"
},
"name": "get_brand",
"outputSchema": {
"additionalProperties": false,
"description": "The public profile of one brand.",
"properties": {
"categories": {
"description": "Product categories.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.",
"type": "integer"
},
"name_de": {
"description": "German category name.",
"type": [
"string",
"null"
]
},
"name_en": {
"description": "English category name.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name_de",
"name_en"
],
"type": "object"
},
"type": [
"array",
"null"
]
},
"details": {
"additionalProperties": false,
"description": "Extended profile details.",
"properties": {
"description": {
"additionalProperties": false,
"description": "Description text in German (de) and English (en); each may be null.",
"properties": {
"de": {
"description": "German text, or null.",
"type": [
"string",
"null"
]
},
"en": {
"description": "English text, or null.",
"type": [
"string",
"null"
]
}
},
"required": [
"de",
"en"
],
"type": [
"object",
"null"
]
},
"hq_country": {
"description": "Headquarters country code, or null.",
"type": [
"string",
"null"
]
},
"registration_date": {
"description": "Date (YYYY-MM-DD) the company registered on authorized.by.",
"type": [
"string",
"null"
]
},
"social": {
"additionalProperties": false,
"description": "Social media profile URLs; each may be null.",
"properties": {
"facebook": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"type": [
"object",
"null"
]
}
},
"required": [
"description",
"hq_country",
"registration_date",
"social"
],
"type": [
"object",
"null"
]
},
"id": {
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.",
"type": "integer"
},
"logo": {
"description": "Logo image URL, or null.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Display name.",
"type": [
"string",
"null"
]
},
"product_count": {
"description": "Number of products registered on authorized.by; null when unknown.",
"type": "integer"
},
"retailer_count": {
"description": "Number of retailers currently authorized by this brand on authorized.by.",
"type": "integer"
},
"slug": {
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.",
"type": [
"string",
"null"
]
},
"website_url": {
"description": "Brand website URL, or null.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"slug",
"website_url",
"logo",
"categories",
"retailer_count",
"product_count",
"details"
],
"type": "object"
}
},
{
"description": "List all retailers (shops) currently authorized by a brand on authorized.by. Read-only. Use this to answer 'is shop X an authorized retailer of brand Y?'. Sorted by subscription plan (PREMIUM, then START, then FREE) and then by brand-connection count descending. Each retailer includes shop_url, seal_implemented (whether the authorized.by seal is live on their shop), official_shop, partnership_date, and certificate_url / certificate_url_de: links to the public authorized.by certificate page (English / German) proving this specific brand-retailer authorization. Share the certificate link when a user needs verifiable proof. Only active partnerships are returned: confirmed by both the brand and the retailer, with both profiles public and the brand approved by authorized.by. Revoked or pending partnerships are never listed. Responses are cached and refreshed when the underlying profile or partnership changes, so a revocation may take a short time to disappear. partnership_date is the date the authorization STARTED, not the date it was last verified; a partnership listed here is currently active as of the response time. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id_or_alias": {
"description": "Brand numeric ID, slug or alias.",
"type": "string"
}
},
"required": [
"id_or_alias"
],
"type": "object"
},
"name": "get_brand_retailers",
"outputSchema": {
"additionalProperties": false,
"description": "All retailers currently authorized by the brand, with per-retailer certificate links.",
"properties": {
"brand_id": {
"description": "Numeric ID of the brand the list belongs to.",
"type": "integer"
},
"premium_count": {
"description": "Number of listed retailers on the PREMIUM plan.",
"type": "integer"
},
"retailers": {
"items": {
"additionalProperties": false,
"properties": {
"brand_count": {
"description": "Number of brands that currently authorize this retailer on authorized.by.",
"type": "integer"
},
"certificate_url": {
"description": "Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization.",
"type": [
"string",
"null"
]
},
"certificate_url_de": {
"description": "Same certificate page in German; null when there is no active authorization.",
"type": [
"string",
"null"
]
},
"details": {
"additionalProperties": false,
"description": "Extended profile details.",
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"categories": {
"description": "Product categories.",
"items": {
"additionalProperties": false,
"properties": {
"de": {
"description": "German text, or null.",
"type": [
"string",
"null"
]
},
"en": {
"description": "English text, or null.",
"type": [
"string",
"null"
]
}
},
"required": [
"de",
"en"
],
"type": "object"
},
"type": [
"array",
"null"
]
},
"description": {
"additionalProperties": false,
"description": "Description text in German (de) and English (en); each may be null.",
"properties": {
"de": {
"description": "German text, or null.",
"type": [
"string",
"null"
]
},
"en": {
"description": "English text, or null.",
"type": [
"string",
"null"
]
}
},
"required": [
"de",
"en"
],
"type": [
"object",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"opening_hours": {
"description": "Weekly opening hours of the physical store; empty or null when unknown.",
"items": {
"additionalProperties": false,
"properties": {
"closing_hour": {
"description": "Closing time.",
"type": [
"string",
"null"
]
},
"day_of_week": {
"description": "Day of the week.",
"type": [
"string",
"null"
]
},
"opening_hour": {
"description": "Opening time.",
"type": [
"string",
"null"
]
}
},
"required": [
"day_of_week",
"opening_hour",
"closing_hour"
],
"type": "object"
},
"type": [
"array",
"null"
]
},
"payment_methods": {
"description": "Accepted payment methods; null when unknown.",
"items": {
"type": "string"
},
"type": [
"array",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"registration_date": {
"description": "Date (YYYY-MM-DD) the company registered on authorized.by.",
"type": [
"string",
"null"
]
},
"social": {
"additionalProperties": false,
"description": "Social media profile URLs; each may be null.",
"properties": {
"facebook": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"type": [
"object",
"null"
]
},
"trustami": {
"additionalProperties": false,
"description": "Customer rating from Trustami; fields are null when no rating exists.",
"properties": {
"profile_url": {
"description": "URL of the rating profile, or null.",
"type": [
"string",
"null"
]
},
"rating": {
"description": "Average customer rating, or null.",
"type": [
"number",
"null"
]
},
"review_count": {
"description": "Number of customer reviews, or null.",
"type": [
"integer",
"null"
]
}
},
"required": [
"rating",
"review_count",
"profile_url"
],
"type": [
"object",
"null"
]
},
"tuv_certification_date": {
"description": "Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified.",
"type": [
"string",
"null"
]
}
},
"required": [
"address",
"phone",
"email",
"opening_hours",
"payment_methods",
"description",
"categories",
"tuv_certification_date",
"registration_date",
"trustami",
"social"
],
"type": [
"object",
"null"
]
},
"id": {
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.",
"type": "integer"
},
"logo": {
"description": "Logo image URL, or null.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Display name.",
"type": [
"string",
"null"
]
},
"official_shop": {
"description": "Whether this shop is the brand's own official shop.",
"type": "boolean"
},
"partnership_date": {
"description": "Date (YYYY-MM-DD) the authorization STARTED. Not a last-verified date: every listed partnership is active as of the response.",
"type": [
"string",
"null"
]
},
"plan": {
"description": "authorized.by subscription plan of the retailer: PREMIUM, START or FREE.",
"type": [
"string",
"null"
]
},
"product_count": {
"description": "Number of products registered on authorized.by; null when unknown.",
"type": [
"integer",
"null"
]
},
"seal_implemented": {
"description": "Whether the authorized.by seal is live on the retailer's shop.",
"type": "boolean"
},
"shop_url": {
"description": "Retailer online-shop URL, or null.",
"type": [
"string",
"null"
]
},
"slug": {
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.",
"type": [
"string",
"null"
]
},
"sponsored": {
"description": "Whether the brand sponsors (highlights) this retailer.",
"type": "boolean"
},
"tuv_certified": {
"description": "Whether the retailer holds a TÜV certification via authorized.by.",
"type": "boolean"
}
},
"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"
],
"type": "object"
},
"type": [
"array",
"null"
]
},
"total": {
"description": "Number of entries in the list.",
"type": "integer"
},
"tuv_certified_count": {
"description": "Number of listed retailers with a TÜV certification.",
"type": "integer"
}
},
"required": [
"brand_id",
"total",
"premium_count",
"tuv_certified_count",
"retailers"
],
"type": "object"
}
},
{
"description": "Search brands (manufacturers) registered on authorized.by, or list them all. Read-only. Returns for each brand: id, name, slug, logo and the number of retailers it has authorized. Omit 'search' to retrieve the full index; use 'page' and 'size' to paginate. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page": {
"description": "Zero-based page number (default 0).",
"type": "integer"
},
"search": {
"description": "Filter by brand name or alias. Optional.",
"type": "string"
},
"size": {
"description": "Page size (default 500).",
"type": "integer"
}
},
"type": "object"
},
"name": "get_brands",
"outputSchema": {
"additionalProperties": false,
"description": "A page of brands plus network-wide totals and pagination.",
"properties": {
"brands": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.",
"type": "integer"
},
"logo": {
"description": "Logo image URL, or null.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Display name.",
"type": [
"string",
"null"
]
},
"retailer_count": {
"description": "Number of retailers currently authorized by this brand on authorized.by.",
"type": "integer"
},
"slug": {
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"slug",
"logo",
"retailer_count"
],
"type": "object"
},
"type": [
"array",
"null"
]
},
"meta": {
"additionalProperties": false,
"description": "Network-wide totals.",
"properties": {
"generated_at": {
"description": "Timestamp (ISO 8601) the index was generated.",
"type": [
"string",
"null"
]
},
"total_brands": {
"description": "Total number of public brands on authorized.by.",
"type": "integer"
},
"total_connections": {
"description": "Total number of active brand-retailer authorizations on authorized.by.",
"type": "integer"
},
"total_retailers": {
"description": "Total number of public retailers on authorized.by.",
"type": "integer"
}
},
"required": [
"total_brands",
"total_retailers",
"total_connections",
"generated_at"
],
"type": [
"object",
"null"
]
},
"pagination": {
"additionalProperties": false,
"description": "Pagination of this response.",
"properties": {
"page": {
"description": "Zero-based page number of this response.",
"type": "integer"
},
"size": {
"description": "Page size used for this response.",
"type": "integer"
},
"total_items": {
"description": "Total number of matching entries across all pages.",
"type": "integer"
},
"total_pages": {
"description": "Total number of pages.",
"type": "integer"
}
},
"required": [
"page",
"size",
"total_items",
"total_pages"
],
"type": [
"object",
"null"
]
}
},
"required": [
"brands",
"meta",
"pagination"
],
"type": "object"
}
},
{
"description": "Get the public profile of one retailer (shop) on authorized.by. Read-only. Returns address, contact details, opening hours, categories, subscription plan, TÜV certification, customer rating, registration date, seal_implemented (whether the authorized.by seal is live on their shop), and certificate_url / certificate_url_de: links to the retailer's public authorized.by certificate page (English / German) listing all brands that authorized it. These links are null when the retailer has no active authorization. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id_or_alias": {
"description": "Retailer numeric ID, slug or alias.",
"type": "string"
}
},
"required": [
"id_or_alias"
],
"type": "object"
},
"name": "get_retailer",
"outputSchema": {
"additionalProperties": false,
"description": "The public profile of one retailer.",
"properties": {
"brand_count": {
"description": "Number of brands that currently authorize this retailer on authorized.by.",
"type": "integer"
},
"certificate_url": {
"description": "Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization.",
"type": [
"string",
"null"
]
},
"certificate_url_de": {
"description": "Same certificate page in German; null when there is no active authorization.",
"type": [
"string",
"null"
]
},
"details": {
"additionalProperties": false,
"description": "Extended profile details.",
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"categories": {
"description": "Product categories.",
"items": {
"additionalProperties": false,
"properties": {
"de": {
"description": "German text, or null.",
"type": [
"string",
"null"
]
},
"en": {
"description": "English text, or null.",
"type": [
"string",
"null"
]
}
},
"required": [
"de",
"en"
],
"type": "object"
},
"type": [
"array",
"null"
]
},
"description": {
"additionalProperties": false,
"description": "Description text in German (de) and English (en); each may be null.",
"properties": {
"de": {
"description": "German text, or null.",
"type": [
"string",
"null"
]
},
"en": {
"description": "English text, or null.",
"type": [
"string",
"null"
]
}
},
"required": [
"de",
"en"
],
"type": [
"object",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"opening_hours": {
"description": "Weekly opening hours of the physical store; empty or null when unknown.",
"items": {
"additionalProperties": false,
"properties": {
"closing_hour": {
"description": "Closing time.",
"type": [
"string",
"null"
]
},
"day_of_week": {
"description": "Day of the week.",
"type": [
"string",
"null"
]
},
"opening_hour": {
"description": "Opening time.",
"type": [
"string",
"null"
]
}
},
"required": [
"day_of_week",
"opening_hour",
"closing_hour"
],
"type": "object"
},
"type": [
"array",
"null"
]
},
"payment_methods": {
"description": "Accepted payment methods; null when unknown.",
"items": {
"type": "string"
},
"type": [
"array",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"registration_date": {
"description": "Date (YYYY-MM-DD) the company registered on authorized.by.",
"type": [
"string",
"null"
]
},
"social": {
"additionalProperties": false,
"description": "Social media profile URLs; each may be null.",
"properties": {
"facebook": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"type": [
"object",
"null"
]
},
"trustami": {
"additionalProperties": false,
"description": "Customer rating from Trustami; fields are null when no rating exists.",
"properties": {
"profile_url": {
"description": "URL of the rating profile, or null.",
"type": [
"string",
"null"
]
},
"rating": {
"description": "Average customer rating, or null.",
"type": [
"number",
"null"
]
},
"review_count": {
"description": "Number of customer reviews, or null.",
"type": [
"integer",
"null"
]
}
},
"required": [
"rating",
"review_count",
"profile_url"
],
"type": [
"object",
"null"
]
},
"tuv_certification_date": {
"description": "Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified.",
"type": [
"string",
"null"
]
}
},
"required": [
"address",
"phone",
"email",
"opening_hours",
"payment_methods",
"description",
"categories",
"tuv_certification_date",
"registration_date",
"trustami",
"social"
],
"type": [
"object",
"null"
]
},
"id": {
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.",
"type": "integer"
},
"logo": {
"description": "Logo image URL, or null.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Display name.",
"type": [
"string",
"null"
]
},
"plan": {
"description": "authorized.by subscription plan of the retailer: PREMIUM, START or FREE.",
"type": [
"string",
"null"
]
},
"seal_implemented": {
"description": "Whether the authorized.by seal is live on the retailer's shop.",
"type": "boolean"
},
"shop_url": {
"description": "Retailer online-shop URL, or null.",
"type": [
"string",
"null"
]
},
"slug": {
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.",
"type": [
"string",
"null"
]
},
"tuv_certified": {
"description": "Whether the retailer holds a TÜV certification via authorized.by.",
"type": "boolean"
}
},
"required": [
"id",
"name",
"slug",
"shop_url",
"logo",
"certificate_url",
"certificate_url_de",
"plan",
"tuv_certified",
"seal_implemented",
"brand_count",
"details"
],
"type": "object"
}
},
{
"description": "List all brands a retailer (shop) is currently authorized to sell, according to authorized.by. Read-only. Use this to answer 'which brands has shop X been authorized for?'. Sorted by brand name. Each entry includes official_shop, partnership_date, and certificate_url / certificate_url_de: links to the public authorized.by certificate page (English / German) proving this specific brand-retailer authorization. Share the certificate link when a user needs verifiable proof. Only active partnerships are returned: confirmed by both the brand and the retailer, with both profiles public and the brand approved by authorized.by. Revoked or pending partnerships are never listed. Responses are cached and refreshed when the underlying profile or partnership changes, so a revocation may take a short time to disappear. partnership_date is the date the authorization STARTED, not the date it was last verified; a partnership listed here is currently active as of the response time. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id_or_alias": {
"description": "Retailer numeric ID, slug or alias.",
"type": "string"
}
},
"required": [
"id_or_alias"
],
"type": "object"
},
"name": "get_retailer_brands",
"outputSchema": {
"additionalProperties": false,
"description": "All brands that currently authorize the retailer, with per-brand certificate links.",
"properties": {
"brands": {
"items": {
"additionalProperties": false,
"properties": {
"certificate_url": {
"description": "Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization.",
"type": [
"string",
"null"
]
},
"certificate_url_de": {
"description": "Same certificate page in German; null when there is no active authorization.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.",
"type": "integer"
},
"logo": {
"description": "Logo image URL, or null.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Display name.",
"type": [
"string",
"null"
]
},
"official_shop": {
"description": "Whether this shop is the brand's own official shop.",
"type": "boolean"
},
"partnership_date": {
"description": "Date (YYYY-MM-DD) the authorization STARTED. Not a last-verified date: every listed partnership is active as of the response.",
"type": [
"string",
"null"
]
},
"slug": {
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.",
"type": [
"string",
"null"
]
},
"website_url": {
"description": "Brand website URL, or null.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"slug",
"website_url",
"logo",
"official_shop",
"certificate_url",
"certificate_url_de",
"partnership_date"
],
"type": "object"
},
"type": [
"array",
"null"
]
},
"retailer_id": {
"description": "Numeric ID of the retailer the list belongs to.",
"type": "integer"
},
"total": {
"description": "Number of entries in the list.",
"type": "integer"
}
},
"required": [
"retailer_id",
"total",
"brands"
],
"type": "object"
}
},
{
"description": "Search retailers (shops) registered on authorized.by, or list them all. Read-only. Returns for each retailer: id, name, slug, shop URL, logo, the number of brands that authorized it, and seal_implemented (whether the authorized.by seal is live on their shop). Omit 'search' to retrieve the full index; use 'page' and 'size' to paginate. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page": {
"description": "Zero-based page number (default 0).",
"type": "integer"
},
"search": {
"description": "Filter by retailer company name or alias. Optional.",
"type": "string"
},
"size": {
"description": "Page size (default 500).",
"type": "integer"
}
},
"type": "object"
},
"name": "get_retailers",
"outputSchema": {
"additionalProperties": false,
"description": "A page of retailers plus network-wide totals and pagination.",
"properties": {
"meta": {
"additionalProperties": false,
"description": "Network-wide totals.",
"properties": {
"generated_at": {
"description": "Timestamp (ISO 8601) the index was generated.",
"type": [
"string",
"null"
]
},
"total_brands": {
"description": "Total number of public brands on authorized.by.",
"type": "integer"
},
"total_connections": {
"description": "Total number of active brand-retailer authorizations on authorized.by.",
"type": "integer"
},
"total_retailers": {
"description": "Total number of public retailers on authorized.by.",
"type": "integer"
}
},
"required": [
"total_brands",
"total_retailers",
"total_connections",
"generated_at"
],
"type": [
"object",
"null"
]
},
"pagination": {
"additionalProperties": false,
"description": "Pagination of this response.",
"properties": {
"page": {
"description": "Zero-based page number of this response.",
"type": "integer"
},
"size": {
"description": "Page size used for this response.",
"type": "integer"
},
"total_items": {
"description": "Total number of matching entries across all pages.",
"type": "integer"
},
"total_pages": {
"description": "Total number of pages.",
"type": "integer"
}
},
"required": [
"page",
"size",
"total_items",
"total_pages"
],
"type": [
"object",
"null"
]
},
"retailers": {
"items": {
"additionalProperties": false,
"properties": {
"brand_count": {
"description": "Number of brands that currently authorize this retailer on authorized.by.",
"type": "integer"
},
"details": {
"additionalProperties": false,
"description": "Extended profile details.",
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"categories": {
"description": "Product categories.",
"items": {
"additionalProperties": false,
"properties": {
"de": {
"description": "German text, or null.",
"type": [
"string",
"null"
]
},
"en": {
"description": "English text, or null.",
"type": [
"string",
"null"
]
}
},
"required": [
"de",
"en"
],
"type": "object"
},
"type": [
"array",
"null"
]
},
"description": {
"additionalProperties": false,
"description": "Description text in German (de) and English (en); each may be null.",
"properties": {
"de": {
"description": "German text, or null.",
"type": [
"string",
"null"
]
},
"en": {
"description": "English text, or null.",
"type": [
"string",
"null"
]
}
},
"required": [
"de",
"en"
],
"type": [
"object",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"opening_hours": {
"description": "Weekly opening hours of the physical store; empty or null when unknown.",
"items": {
"additionalProperties": false,
"properties": {
"closing_hour": {
"description": "Closing time.",
"type": [
"string",
"null"
]
},
"day_of_week": {
"description": "Day of the week.",
"type": [
"string",
"null"
]
},
"opening_hour": {
"description": "Opening time.",
"type": [
"string",
"null"
]
}
},
"required": [
"day_of_week",
"opening_hour",
"closing_hour"
],
"type": "object"
},
"type": [
"array",
"null"
]
},
"payment_methods": {
"description": "Accepted payment methods; null when unknown.",
"items": {
"type": "string"
},
"type": [
"array",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"registration_date": {
"description": "Date (YYYY-MM-DD) the company registered on authorized.by.",
"type": [
"string",
"null"
]
},
"social": {
"additionalProperties": false,
"description": "Social media profile URLs; each may be null.",
"properties": {
"facebook": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"type": [
"object",
"null"
]
},
"trustami": {
"additionalProperties": false,
"description": "Customer rating from Trustami; fields are null when no rating exists.",
"properties": {
"profile_url": {
"description": "URL of the rating profile, or null.",
"type": [
"string",
"null"
]
},
"rating": {
"description": "Average customer rating, or null.",
"type": [
"number",
"null"
]
},
"review_count": {
"description": "Number of customer reviews, or null.",
"type": [
"integer",
"null"
]
}
},
"required": [
"rating",
"review_count",
"profile_url"
],
"type": [
"object",
"null"
]
},
"tuv_certification_date": {
"description": "Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified.",
"type": [
"string",
"null"
]
}
},
"required": [
"address",
"phone",
"email",
"opening_hours",
"payment_methods",
"description",
"categories",
"tuv_certification_date",
"registration_date",
"trustami",
"social"
],
"type": [
"object",
"null"
]
},
"id": {
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.",
"type": "integer"
},
"logo": {
"description": "Logo image URL, or null.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Display name.",
"type": [
"string",
"null"
]
},
"seal_implemented": {
"description": "Whether the authorized.by seal is live on the retailer's shop.",
"type": "boolean"
},
"shop_url": {
"description": "Retailer online-shop URL, or null.",
"type": [
"string",
"null"
]
},
"slug": {
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"slug",
"shop_url",
"logo",
"seal_implemented",
"brand_count",
"details"
],
"type": "object"
},
"type": [
"array",
"null"
]
}
},
"required": [
"retailers",
"meta",
"pagination"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:f6fd31611133f4b15607a7c2b0070a4571908588efa98d5bdcb460c4ba0c45dd | sha256sum