$ man qr-code-decode
/qr-code-decode(1)
PRICE / CALL
$0.002
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
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.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| image_url | string | Public http(s) URL of an image containing one or more QR codes. Must be directly fetchable. | required |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| codes | string | Array of decoded text strings extracted from QR codes found in the image, one entry per detected code. |
| source | string | Upstream decoder used (qrserver.com's read-qr-code API) that produced the decoded results. |
EXAMPLES — two 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
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| arxiv-bibtex | arXiv to BibTeX / arxiv citation generator / paper bibtex / LaTeX citation builder / academic citation lookup. | $0.002 |
| github-readme | GitHub README fetch / repo readme / open-source-readme-as-markdown / package documentation puller. | $0.002 |
| keyword-suggest | Keyword autocomplete / search suggest / SEO keyword research / query expansion / autocomplete suggestions. | $0.002 |
| hacker-news-search | Hacker News search / HN search / yc-news / Algolia HN. | $0.001 |
| hn-search | HN search / Hacker News search / yc-news / startup-news search / Algolia HN / who-is-hiring scraper / programmer-news firehose. | $0.001 |
| homoglyph-check | Homoglyph attack detector / Unicode lookalike scanner. | $0.003 |
| ip-asn | IP to ASN / IP geolocation / IP-to-ISP lookup / WHOIS for IP / cloud-provider attribution. | $0.001 |
| jwt-decode | JWT decoder / token inspector / debug tool. | $0.003 |
SEE ALSO