{"uid":"cap_SO62JG3UUja6PTeq8GbCY","slug":"tanod-qr-code-reader-ad989e96","name":"Tanod QR Code Reader","description":"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.","url":"https://tanod.dev/v1/image/qr-read?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wXS2qvfSDtrOdS2iSZez7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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","exampleAgentPrompt":"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","exampleUseCases":[{"title":"Validate a PIX payment QR before sending","prompt":"I need to verify this PIX QR code before my customer scans it — can you decode it from this URL and check that the CRC is valid, and tell me the merchant name and amount? https://mystore.com/checkout-qr.png"},{"title":"Extract URL or text from product QR code","prompt":"Read the QR code in this base64 image for me and tell me what text or URL it encodes — here's the image data: data:image/png;base64,iVBORw0KGgo..."},{"title":"Parse PromptPay QR for accounting records","prompt":"I have a PromptPay QR code image at https://payments.example.com/promptpay-receipt.png — can you decode it and pull out the payment amount, currency, and merchant details for my records?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T06:43:45.981Z","isFirstParty":false,"canonicalSlug":"tanod-qr-code-reader-ad989e96"}