Bestseller
QR Code Barcode Tools Image Decoding
Decode QR Code from Image
Decode QR code content from an uploaded image and return the parsed value, format, and detection points.
Data & API Features
Decode QR code values from uploaded images;
Return the parsed content and raw decoded text;
Include detection points for downstream visual workflows;
Useful for ticketing, logistics, payments, and inventory apps;
Works well for mobile uploads, scanned images, and generated QR assets;
Annual Subscription
$19$49
Try it for free!
Sign In Sign in to get a trial key and test all APIs.
Secure payment by Stripe
API Document
HTTP Protocol:HTTPS
HTTP Method:POST
HTTP Endpoint:https://api.gugudata.io/v1/barcode/qrcode/decode
Response Type:application/json; charset=utf-8
DEMO Endpoint:https://api.gugudata.io/v1/barcode/qrcode/decode/demo
Live Demo:Try Interactive Demo
Full API Docs:developers.gugudata.io
API Request Parameters
| Name | Type | Is Required | Default Value | Remark |
|---|---|---|---|---|
| appkey | string | true | YOUR_APPKEY | Obtained after payment |
| file | file | true | N/A | Image file that contains a QR code |
API Response Parameters
| Name | Type | Remark |
|---|---|---|
| format | string | Detected code format |
| parsed | string | Parsed QR code content |
| points | array<string> | Detected corner points of the QR code |
| raw | string | Raw decoded string |
| type | string | Detected payload type, such as URI, WIFI, EMAIL, or TEXT |
API Response Status Codes
| Status Code | Explanation of Status Code | Remarks |
|---|---|---|
| 200 | Request processed successfully. | Some endpoints expose a separate application-level status field in the response body, such as `dataStatus.statusCode`. |
| 400 | Invalid request parameters or request format. | Check required fields, data types, and request body format. |
| 401 | Missing or unknown application key. | Provide a valid `appkey` with the request. |
| 403 | The application key is recognized but access is not allowed. | The key may be expired, inactive, or not permitted for the requested API. |
| 429 | Request rate or trial usage limit exceeded. | Reduce concurrency or retry after the limit window resets. |
| 500 | Internal service error. | Retry later or contact support if the error persists. |
| 503 | Upstream service unavailable. | Retry later; the requested upstream dependency is temporarily unavailable. |
