# Tanod QR Code Reader

> Tanod QR Code Reader is a paid API for AI agents from tanod.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-20).

Reads and decodes QR codes (and barcodes) from an image URL or base64 data, with optional EMVCo payment payload parsing for PIX, PromptPay, SGQR, and similar standards

## Facts

- Endpoint: POST https://tanod.dev/v1/image/qr-read?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-qr-code-reader-ad989e96
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SO62JG3UUja6PTeq8GbCY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tanod-qr-code-reader-ad989e96 -d '<json body>'
```

Example prompt: Can you read the QR code in this image and tell me what it says — if it's a payment QR (like PIX or PromptPay), also parse out the merchant name, amount, and whether the CRC is valid? Here's the image URL: https://example.com/payment-qr.png

## When to prefer this

Choose this endpoint when you need to decode QR codes or barcodes from images programmatically, especially when you also need EMVCo/payment QR parsing (PIX, PromptPay, SGQR, DuitNow, QR Ph) with CRC validation and structured merchant data — capabilities rarely bundled together in generic OCR APIs. It requires no signup and charges only $0.002 per call, making it cost-effective for occasional or automated use.

## Known failure modes

- Image URL is private, internal, or IP-literal host — refused with error
- Image exceeds 10 MB — rejected
- No QR or barcode found in image — returns empty codes array
- Malformed base64 input — decode error
- Image format not supported — error response
- QR text is not valid EMVCo TLV — emv field may show valid_tlv: false with warnings
- Network timeout fetching remote image URL

## How this service works

imagepeek (Tanod) QR and barcode reader: decoded text, type and position of every code in an image. Use when an image holds QR codes or barcodes whose decoded text, positions or payment fields are needed.

## Output

Returns an array of decoded codes found in the image, each with the raw decoded text, code type (QR/barcode variant), bounding box coordinates, and corner points. For EMVCo payment QRs, also returns fully parsed fields: payment scheme (PIX, PromptPay, SGQR, etc.), merchant name and city, currency, amount, CRC validity, merchant account information, and any warnings. Also includes image metadata (format, dimensions, file size, animated) and the library attribution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 2048
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Public http(s) URL of the image (at most 10 MB; private, internal and IP-literal hosts are refused); or use image_base64."
  },
  "parse_emv": {
   "type": "boolean",
   "default": true,
   "description": "Also return `emv`, the parsed fields and CRC check, for a QR whose text is an EMVCo payment payload (starts 000201: PIX, QR Ph, SGQR, PromptPay, DuitNow, ...). Default true."
  },
  "image_base64": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 13333464
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "The image as standard or url-safe base64 (at most 10 MB decoded; a data:image/...;base64, prefix is fine); or use url."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "codes": [
   {
    "emv": {
     "crc": {
      "valid": true,
      "computed": "65E2",
      "declared": "65E2"
     },
     "amount": null,
     "scheme": "PIX",
     "currency": {
      "alpha": "BRL",
      "numeric": "986"
     },
     "warnings": [],
     "valid_tlv": true,
     "postal_code": null,
     "country_code": "BR",
     "merchant_city": "BRASILIA",
     "merchant_name": "LOJA TEST",
     "additional_data": {
      "reference_label": "***"
     },
     "point_of_initiation": {
      "code": "12",
      "method": "dynamic"
     },
     "merchant_category_code": "0000",
     "tip_or_convenience_fee": null,
     "payload_format_indicator": "01",
     "merchant_account_information": [
      {
       "id": "26",
       "pix": {
        "key": "123e4567-e89b-12d3-a456-426655440000"
       },
       "guid": "br.gov.bcb.pix",
       "fields": {
        "01": "123e4567-e89b-12d3-a456-426655440000"
       },
       "scheme": "PIX"
      }
     ]
    },
    "bbox": {
     "top": 32,
     "left": 32,
     "width": 392,
     "height": 392
    },
    "kind": "payment_emv",
    "text": "00020101021226580014br.gov.bcb.pix0136123e4567-e89b-12d3-a456-4266554400005204000053039865802BR5909LOJA TEST6008BRASILIA62070503***630465E2",
    "type": "QR",
    "points": [
     [
      32,
      32
     ],
     [
      423,
      32
     ],
     [
      423.1,
      423.7
     ],
     [
      32,
      423
     ]
    ],
    "text_truncated": false
   }
  ],
  "count": 1,
  "input": {
   "bytes": 808,
   "width": 456,
   "format": "png",
   "frames": 1,
   "height": 456,
   "animated": false,
   "has_alpha": false
  },
  "notes": [],
  "source": {
   "url": "https://opencv.org",
   "library": "OpenCV (QR, EAN, UPC) + Tanod scan-line reader (Code 128, Code 39)",
   "license": "Apache-2.0"
  },
  "final_url": "https://tanod.dev/examples/qr-sample-pix.png",
  "operation": "qr-read",
  "source_url": "https://tanod.dev/examples/qr-sample-pix.png",
  "untrusted_content": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-qr-code-reader-ad989e96/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)