# Vextorium QR & Barcode Reader

> Vextorium QR & Barcode Reader is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-11).

Reads barcodes and QR codes from an image URL, returning format, decoded content, position, and content type classification (URLs, crypto URIs, Wi-Fi credentials, etc.)

## Facts

- Endpoint: POST https://api.vextorium.com/v1/qr-barcode-read?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-qr-barcode-reader-4155fc53
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zz0cYUgc-FIEfvnk4NitU

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 vextorium-qr-barcode-reader-4155fc53 -d '<json body>'
```

Example prompt: Can you read the QR code in this image and tell me what it contains — https://upload.wikimedia.org/wikipedia/commons/thumb/d/d0/QR_code_for_mobile_English_Wikipedia.svg/500px-QR_code_for_mobile_English_Wikipedia.svg.png?

## When to prefer this

Choose this endpoint when you need to programmatically decode any standard 1D or 2D barcode format from an image URL, especially when you also need structured metadata like bounding-box position, content type classification (URL vs crypto URI vs Wi-Fi), and safety flags. It supports a broader range of formats (QR, Data Matrix, Aztec, PDF417, EAN-13, UPC, Code 128, Code 39) than many single-format decoders.

## Known failure modes

- Image URL is unreachable or returns a non-image response — no codes returned
- Image contains no detectable barcode or QR code — found_codes: 0
- Damaged or low-resolution barcode cannot be decoded by zxing-cpp
- Unsupported image format causing decoding failure
- Rate limiting or payment failure via x402 protocol

## How this service works

Read the codes in an image URL: QR, Data Matrix, Aztec, PDF417, EAN-13, UPC, Code 128, Code 39... with format, content and position; flags URLs, crypto payment URIs (bitcoin:, ethereum:, solana:) and wifi credentials.

## Output

Returns a JSON object with the number of codes found, an array of decoded codes each containing: format name (e.g. 'QR Code', 'EAN-13'), decoded content string, content type classification (url, crypto payment URI, wifi, plain text, etc.), and pixel position (top-left and bottom-right corners). Also includes the source image URL, dimensions, and a safety notice for URL-type codes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "high": {
       "type": [
        "number",
        "null"
       ]
      },
      "codes": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "format": {
          "type": [
           "string",
           "null"
          ]
         },
         "content": {
          "type": [
           "string",
           "null"
          ]
         },
         "position": {
          "type": [
           "object",
           "null"
          ],
          "properties": {
           "top_left": {
            "type": [
             "array",
             "null"
            ],
            "items": {
             "type": [
              "null",
              "number"
             ]
            }
           },
           "bottom_right": {
            "type": [
             "array",
             "null"
            ],
            "items": {
             "type": [
              "null",
              "number"
             ]
            }
           }
          }
         },
         "content_type": {
          "type": [
           "string",
           "null"
          ]
         }
        }
       }
      },
      "image": {
       "type": [
        "string",
        "null"
       ]
      },
      "width": {
       "type": [
        "number",
        "null"
       ]
      },
      "notice": {
       "type": [
        "string",
        "null"
       ]
      },
      "source": {
       "type": [
        "string",
        "null"
       ]
      },
     
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "high": 500,
  "codes": [
   {
    "format": "QR Code",
    "content": "http://en.m.wikipedia.org",
    "position": {
     "top_left": [
      54,
      54
     ],
     "bottom_right": [
      446,
      446
     ]
    },
    "content_type": "url"
   }
  ],
  "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/d0/QR_code_for_mobile_English_Wikipedia.svg/500px-QR_code_for_mobile_English_Wikipedia.svg.png",
  "width": 500,
  "notice": "Before opening a URL from a QR code, check its safety (malicious-url).",
  "source": "zxing-cpp (lectura local)",
  "found_codes": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-qr-barcode-reader-4155fc53/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)