# QR Code & Barcode Generator

QR code generator, barcode generator (EAN-13, EAN-8, Code 128, Code 39) and reader in one API. PNG or SVG with a proper quiet zone.

Send text and get a QR code or barcode back as PNG or SVG, with a proper quiet zone. EAN check digits are verified or added for you, and data that cannot be encoded is refused before any charge.

- Generate and read with one subscription: the reader finds every QR code and barcode in an image.
- EAN check digits are verified or added for you.
- Data that cannot be encoded is refused before any charge, and an image with no code in it costs nothing.

## Calls

### `POST https://readymadeapi.com/v1/qr`

Encode text or a URL as a QR code. PNG by default, SVG with format=svg.

- Price: $0.0005 per code
- MCP tool: `qr_barcode_qr`
- Answers in the same call.

Request:

```json
{
  "data": "https://example.com",
  "size": 512
}
```

The answer is the file itself (`image/png`).

### `POST https://readymadeapi.com/v1/barcode`

Encode a Code 128, Code 39, EAN-13 or EAN-8 barcode. PNG by default, SVG with format=svg.

- Price: $0.0005 per code
- MCP tool: `qr_barcode_barcode`
- Answers in the same call.

Request:

```json
{
  "data": "5901234123457",
  "symbology": "ean13"
}
```

The answer is the file itself (`image/png`).

### `POST https://readymadeapi.com/v1/codes/read`

Find and decode every QR code and barcode in an image: QR, Data Matrix, Aztec, PDF417, EAN, UPC, Code 128, Code 39, ITF and more. Nothing found, nothing charged.

- Price: $0.001 per image
- MCP tool: `qr_barcode_read`
- Answers in the same call.

Request:

```json
{
  "image_url": "https://readymadeapi.com/samples/qr.png"
}
```

Answer:

```json
{
  "count": 1,
  "codes": [
    {
      "format": "qrcode",
      "text": "https://example.com",
      "bounds": [61, 61, 375, 375]
    }
  ]
}
```

## Limits

- Barcodes: Code 128, Code 39, EAN-13, EAN-8.
- QR codes: up to 2,000 bytes of data, 64 to 4,096 pixels, error correction L, M, Q or H.
- Reader: PNG, JPEG or WebP; by link, up to 15 MB; up to 50 codes per image.

## Questions

**Which codes does the reader know?**

QR, Data Matrix, Aztec, PDF417, EAN, UPC, Code 128, Code 39, ITF and more.

**Can the QR code have a logo or colours?**

No. Plain black-and-white codes with a full quiet zone.

**Are the digits printed under an EAN barcode?**

No. The image is the bars and quiet zone only.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
