Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint
$ man qr-code-decode

/qr-code-decode(1)

agentutility / web-probe / qr-code-decode
PRICE / CALL
$0.002
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobe
CATEGORY
uncategorized
STATUS
live
NAME
qr-code-decode qr decoder / qr reader / scan qr from url / qr code ocr / barcode reader / link extraction from qr
SYNOPSIS
POST https://x402.org/v1/qr-code-decode
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

QR decoder / QR reader / scan QR from URL / QR code OCR / barcode reader / link extraction from QR. Reads QR codes out of any public image URL (PNG / JPG / GIF / BMP) and returns the decoded text strings. Multiple QR codes in a single image are returned as separate entries. Wraps qrserver.com's free public read-qr-code API (true DIY decode requires canvas, which Workers don't have natively). Returns an empty `codes` array plus a descriptive `note` if the image can't be fetched or no QR is found.

INPUTrequest schema
propertytypedescriptionreq?
image_urlstringPublic http(s) URL of an image containing one or more QR codes. Must be directly fetchable.required
OUTPUTresponse shape
fieldtypedescription
codesstringArray of decoded text strings extracted from QR codes found in the image, one entry per detected code.
sourcestringUpstream decoder used (qrserver.com's read-qr-code API) that produced the decoded results.
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/qr-code-decode \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the qr-code-decode tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
web-probeqr-codeqr-decoderbarcode-readerimage-ocrlink-extractionqr-scanner
methods
POST
cluster
webprobe
price
$0.002 USDC per call
ADJACENTother endpoints in webprobe
endpointdescriptionprice
arxiv-bibtexarXiv to BibTeX / arxiv citation generator / paper bibtex / LaTeX citation builder / academic citation lookup.$0.002
github-readmeGitHub README fetch / repo readme / open-source-readme-as-markdown / package documentation puller.$0.002
keyword-suggestKeyword autocomplete / search suggest / SEO keyword research / query expansion / autocomplete suggestions.$0.002
hacker-news-searchHacker News search / HN search / yc-news / Algolia HN.$0.001
hn-searchHN search / Hacker News search / yc-news / startup-news search / Algolia HN / who-is-hiring scraper / programmer-news firehose.$0.001
homoglyph-checkHomoglyph attack detector / Unicode lookalike scanner.$0.003
ip-asnIP to ASN / IP geolocation / IP-to-ISP lookup / WHOIS for IP / cloud-provider attribution.$0.001
jwt-decodeJWT decoder / token inspector / debug tool.$0.003
SEE ALSO
agentutility(7) · webprobe(7) · x402(7) · mcp(7) · llms.txt · registry.json · bazaar.x402.org