Fetch GTIN
fetch_gtinWhat is this GTIN? Returns the signed record for a GTIN-8/12/13/14: product, brand, maker, category and pack where a source page states them, each with the pages it was read from and the date it was read; seen_in markets and banners; confidence confirmed (two or more independent domains agree) or seen (one). A GTIN with no observation answers status unknown with no fields — never a guess. Pass market (hub market code; UK accepted for GB) to tag the ask with the market: a miss is queued as a lead for that market. Can it be sold there is the hub's gate, not this door's. Extended 2026-11-13: every answer also carries answer (verified · not verified · unknown, by the published rule at https://gtinfetch.ai/rule.json), reason, facts with the variant facts (size, pack count, type), facts_compared, sources_read (each source with its last-read date), rule_version and region. Optional inputs: market (used for the recall check), believes {brand, product, size} (what you believe you are buying), receipt (true writes a signed receipt of the check in the same call at https://rco.wefetch.ai/; anyone can check it at https://rco-barcodeverified.org/verify). A barcode-only call returns everything it returned before, with the new fields beside the old.
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": {
"gtin": "<gtin>"
},
"name": "fetch_gtin"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gtin | Yes | 8, 12, 13 or 14 digits | |
| market | No | optional hub market code, e.g. UK, US, FR | |
| receipt | No | optional: true writes a signed receipt of this check in the same call, at https://rco.wefetch.ai/. The answer is always given; the receipt is what is paid for. | |
| believes | No | optional: what the agent believes it is buying, as the agent holds it. Checked against the record; facts_compared says what was checked and what could not be. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | ||
| facts | No | brand, product, maker, category and the variant facts the record holds: size, pack count, type | |
| answer | No | the firm answer, by the published rule. verified: the barcode is on record with at least one source and no conflict. not verified: the sources conflict with each other, or a recall or correction stands against the record. unknown: the barcode is not on record; it is added to the sourcing queue. On verified, go ahead; on not verified, stop and correct, or ask your principal; on unknown, treat as unchecked. | |
| fields | No | ||
| gtin14 | Yes | ||
| reason | No | one plain sentence saying why; always present. On verified it states the number of sources that hold the barcode. | |
| region | No | which region answered | |
| status | Yes | ||
| receipt | No | present if a receipt was asked for: number, state (signed | pending), and where to check it | |
| sources | No | ||
| signature | No | ||
| confidence | No | ||
| rule_version | No | the version of the published rule that produced the answer (https://gtinfetch.ai/rule.json) | |
| sources_read | No | each source behind the record with the date it was last read | |
| facts_compared | No | which of the agent's stated facts were checked against the record (checked[]), and which could not be (not_checked[]) |