Verify a retailer's authorization
verify_retailer_authorizationCheck whether a shop is an authorized retailer of a brand, from the shop's domain or URL plus the brand or one of its products' GTIN (EAN). Read-only. Use this when you know the seller's domain, e.g. from a shopping or UCP catalog result. Pass exactly one of 'brand' or 'gtin'; a GTIN resolves the product's brand and the check stays brand-level. status: AUTHORIZED = authorization active: the brand has confirmed this shop on authorized.by; official_shop, partnership_date and certificate_url / certificate_url_de prove it, share the certificate link when a user needs proof; 'brand' in the answer is the brand that was checked. NO_RECORD_FOR_BRAND = the shop and the brand are on authorized.by, but this brand has not confirmed this shop there (also when a GTIN belongs to several brands and not exactly one confirmed it; brand is then null). RETAILER_NOT_REGISTERED = no public shop on authorized.by at this domain. BRAND_NOT_REGISTERED = 'brand' does not identify exactly one public brand (the brand is not on authorized.by, or the value is a name shared by several brands or only part of a brand's name), or no product matches 'gtin'; before telling a user that a brand is not on authorized.by, search get_brands with the name and call again with the slug of the brand that was meant. None of these statuses means that the shop is unauthorized. Domains match exactly, never a parent domain or another subdomain (www. and m. count as the same shop); marketplace hosts such as amazon.de or ebay.de only match the exact store URL. The answer is computed live, never cached. 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": {
"retailer_domain": "<retailer_domain>"
},
"name": "verify_retailer_authorization"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gtin | No | GTIN / EAN of a product of the brand, 8 to 14 or 18 digits. Omit when passing 'brand'. | |
| brand | No | Brand numeric ID, slug, alias, website domain or name, e.g. 'deuter', 'deuter.com' or 'Napoleon'. A number is always read as an ID. A name is only accepted when it identifies exactly one brand; otherwise use get_brands to find the slug. Omit when passing 'gtin'. | |
| retailer_domain | Yes | Shop domain or URL, e.g. 'best-shop.de' or 'https://www.best-shop.de/de/grills'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gtin | Yes | The checked GTIN, normalized to 14 digits (18 for GTIN-18); null when checked by brand. | |
| brand | Yes | The checked brand, also when it was given by its name; null when the shop or the brand is not registered, or when a GTIN matches several brands and not exactly one of them confirmed the shop. | |
| status | Yes | Outcome of the check: AUTHORIZED (authorization active), NO_RECORD_FOR_BRAND, RETAILER_NOT_REGISTERED or BRAND_NOT_REGISTERED. None of them means that the shop is unauthorized. | |
| retailer | Yes | The authorized.by shop registered at this domain; null when there is none. | |
| checked_at | Yes | Timestamp (ISO 8601) the check was made; answers are never cached. | |
| official_shop | Yes | true when this shop is the brand's own official online shop, false when it is an independent authorized retailer. In verify_retailer_authorization it is null unless the status is AUTHORIZED. | |
| 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. | |
| retailer_domain | Yes | The checked shop domain and path, as parsed from the request. | |
| partnership_date | Yes | Date (YYYY-MM-DD) this brand's authorization of this retailer STARTED on authorized.by. Not the date either company joined authorized.by and not a last-verified date: every listed partnership is active as of the response. | |
| certificate_url_de | Yes | Same certificate page in German; null when there is no active authorization. |