Get retailer profile
get_retailerGet the public profile of one retailer (shop) on authorized.by. Read-only. Returns address, contact details, opening hours, categories, registration date, tuv_certified (shop identity verified in the TÜV Saarland ShopIdent procedure: an identity check, not a certification of the retailer's business), the number of brands that authorized it, 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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id_or_alias": "<id_or_alias>"
},
"name": "get_retailer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id_or_alias | Yes | Retailer numeric ID, slug or alias. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools. | |
| logo | Yes | Logo image URL, or null. | |
| name | Yes | Display name. | |
| slug | Yes | URL-safe identifier. Accepted by the id_or_alias argument of the detail tools. | |
| details | Yes | Extended profile details. | |
| shop_url | Yes | Retailer online-shop URL, or null. | |
| brand_count | Yes | Number of brands with a public, approved profile that currently authorize this retailer on authorized.by. Only authorizations confirmed by both the brand and the retailer count; pending requests and ended authorizations do not. | |
| tuv_certified | Yes | Whether the identity of the shop has been verified in the TÜV Saarland ShopIdent procedure, arranged through authorized.by. It is an identity check of the shop operator, not a certification of the retailer's business, service or products. | |
| certificate_url | Yes | Public authorized.by certificate page (English) that proves the authorization: of this brand and retailer where the entry is about both, otherwise the retailer's page listing all brands that authorize it. Null when there is no active authorization. | |
| certificate_url_de | Yes | Same certificate page in German; null when there is no active authorization. |