barcode_batch

Call this tool to draw many barcodes or QR codes at once from a list of rows, each with its own value and file name. Every row comes back as its own download link valid for one hour. Pro; the free tier does one code per call.

Argument	Type	Description
text	boolean	Print the digits under the bars (default true)
items*	array	The rows to draw
format	string	svg (default, free) or png (Pro)
height	integer	Bar height in the same units (default 80)
out_dir	string	Ignored on this hosted endpoint: there are no directories, and every row comes back as its own download link
out_path	string	Name for the downloaded file, e.g. acme-code. SVG is returned inline when this is left out; a PNG always comes back as a download link valid for one hour
overwrite	boolean	Replace a file of the same name already produced in this request (default false)
symbology	string	Default symbology for rows that do not name one (default code128)
module_width	integer	Width of the narrowest bar, in pixels or SVG units (default 2)
stop_on_error	boolean	Stop at the first bad row instead of drawing the rest and reporting it (default false)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "items"
  ],
  "properties": {
    "text": {
      "type": "boolean",
      "description": "Print the digits under the bars (default true)"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "value"
        ],
        "properties": {
          "value": {
            "type": "string",
            "description": "The data to encode"
          },
          "filename": {
            "type": "string",
            "description": "File name without an extension. Defaults to the value, made safe"
          },
          "symbology": {
            "enum": [
              "code128",
              "ean13",
              "ean8",
              "upca",
              "qr"
            ],
            "type": "string",
            "description": "Defaults to the call's symbology"
          }
        },
        "additionalProperties": false
      },
      "description": "The rows to draw"
    },
    "format": {
      "enum": [
        "svg",
        "png"
      ],
      "type": "string",
      "description": "svg (default, free) or png (Pro)"
    },
    "height": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 10,
      "description": "Bar height in the same units (default 80)"
    },
    "out_dir": {
      "type": "string",
      "description": "Ignored on this hosted endpoint: there are no directories, and every row comes back as its own download link"
    },
    "out_path": {
      "type": "string",
      "description": "Name for the downloaded file, e.g. acme-code. SVG is returned inline when this is left out; a PNG always comes back as a download link valid for one hour"
    },
    "overwrite": {
      "type": "boolean",
      "description": "Replace a file of the same name already produced in this request (default false)"
    },
    "symbology": {
      "enum": [
        "code128",
        "ean13",
        "ean8",
        "upca",
        "qr"
      ],
      "type": "string",
      "description": "Default symbology for rows that do not name one (default code128)"
    },
    "module_width": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Width of the narrowest bar, in pixels or SVG units (default 2)"
    },
    "stop_on_error": {
      "type": "boolean",
      "description": "Stop at the first bad row instead of drawing the rest and reporting it (default false)"
    }
  },
  "additionalProperties": false
}

barcode_create

Call this tool to draw a linear barcode (code128, ean13, ean8, upca) as SVG, or PNG to out_path. A short EAN or UPC gets its check digit computed; a wrong one is refused, never redrawn. qr_create makes QR codes.

Argument	Type	Description
text	boolean	Print the digits under the bars (default true)
value*	string	The data to encode. Digits only for EAN and UPC
format	string	svg (default, free) or png (Pro)
height	integer	Bar height in the same units (default 80)
out_path	string	Name for the downloaded file, e.g. acme-code. SVG is returned inline when this is left out; a PNG always comes back as a download link valid for one hour
overwrite	boolean	Replace a file of the same name already produced in this request (default false)
symbology*	string	code128 for any printable ASCII, ean13 and ean8 for retail products, upca for North American retail
module_width	integer	Width of the narrowest bar, in pixels or SVG units (default 2)

Input schema (JSON)

code_list

List the codes this server generated, newest first, with what each carried and where it went, plus how much of the free 20 a month is used. Filter by kind. It reads the register, not the files.

read-only

Argument	Type	Description
kind	string	Only rows of this kind: text, wifi, vcard, sepa, invoice, barcode or batch
limit	integer	How many rows to show, newest first (default 20)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "kind": {
      "type": "string",
      "description": "Only rows of this kind: text, wifi, vcard, sepa, invoice, barcode or batch"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "How many rows to show, newest first (default 20)"
    }
  },
  "additionalProperties": false
}

invoice_payment_qr

Call this tool for a SEPA payment QR from just an amount and reference: IBAN and name are read from the shared business profile, never asked for; pass invoice_id instead to take the amount from an invoice.

Argument	Type	Description
iban	string	Override the IBAN in the shared business profile
name	string	Override the beneficiary name in the shared business profile
size	integer	PNG width in pixels, 32 to 4000 (default 300). SVG scales without it
amount	number	Amount in EUR. Overrides the invoice total; required when there is no invoice to read
format	string	svg (default, free) or png (Pro)
margin	integer	Quiet zone in modules, default 4, which is what the QR standard requires
out_path	string	Name for the downloaded file, e.g. acme-code. SVG is returned inline when this is left out; a PNG always comes back as a download link valid for one hour
overwrite	boolean	Replace a file of the same name already produced in this request (default false)
reference

license_activate

Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.

Argument	Type	Description
key*	string	License key from checkout, MCPL1.<payload>.<signature>

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "License key from checkout, MCPL1.<payload>.<signature>"
    }
  },
  "additionalProperties": false
}

license_status

Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

qr_create

Call this tool to turn text or a URL into a QR code: SVG inline, or a PNG at a pixel size to out_path (Pro). Returns version, module grid and payload size. Free: 20 codes a month on this server.

Argument	Type	Description
size	integer	PNG width in pixels, 32 to 4000 (default 300). SVG scales without it
text*	string	The text or URL the code carries
format	string	svg (default, free) or png (Pro)
margin	integer	Quiet zone in modules, default 4, which is what the QR standard requires
out_path	string	Name for the downloaded file, e.g. acme-code. SVG is returned inline when this is left out; a PNG always comes back as a download link valid for one hour
overwrite	boolean	Replace a file of the same name already produced in this request (default false)
error_correction	string	L 7%, M 15% (default), Q 25%, H 30% of the code recoverable when damaged

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "text"
  ],
  "properties": {
    "size": {
      "type": "integer",
      "description": "PNG width in pixels, 32 to 4000 (default 300). SVG scales without it"
    },
    "text": {
      "type": "string",
      "description": "The text or URL the code carries"
    },
    "format": {
      "enum": [
        "svg",
        "png"
      ],
      "type": "string",
      "description": "svg (default, free) or png (Pro)"
    },
    "margin": {
      "type": "integer",
      "maximum": 20,
      "minimum": 0,
      "description": "Quiet zone in modules, default 4, which is what the QR standard requires"
    },
    "out_path": {
      "type": "string",
      "description": "Name for the downloaded file, e.g. acme-code. SVG is returned inline when this is left out; a PNG always comes back as a download link valid for one hour"
    },
    "overwrite": {
      "type": "boolean",
      "description": "Replace a file of the same name already produced in this request (default false)"
    },
    "error_correction": {
      "enum": [
        "L",
        "M",
        "Q",
        "H"
      ],
      "type": "string",
      "description": "L 7%, M 15% (default), Q 25%, H 30% of the code recoverable when damaged"
    }
  },
  "additionalProperties": false
}

qr_payment_sepa

Call this tool for an EPC069-12 payment QR a euro banking app can scan. Amount and reference are enough: the beneficiary IBAN and name default to the shared business profile, never asked for.

Argument	Type	Description
bic	string	Beneficiary BIC. Optional under EPC version 002
iban	string	Beneficiary IBAN. Defaults to the iban in the shared business profile (set once with the invoice server's business_set). Checked with ISO 7064 mod 97 and refused if it does not validate
name	string	Beneficiary name, up to 70 characters. Defaults to the name in the shared business profile
size	integer	PNG width in pixels, 32 to 4000 (default 300). SVG scales without it
amount	number	Amount in EUR, 0.01 to 999999999.99. Leave out and the payer types it
format	string	svg (default, free) or png (Pro)
margin	integer	Quiet zone in modules, default 4, which is what the QR standard requires
purpose	string	Four-letter ISO 20022 purpose code, for example GDDS
currency	string

qr_vcard

Call this tool to make a QR code that adds a contact when scanned (vCard 3.0). For your own card pass nothing: name, phone, email and address default to the shared business profile, never asked for.

Argument	Type	Description
org	string	Company or organisation
url	string	Website
name	string	Full name, for example Anna Kowalska. Defaults to the shared business profile's name; pass it only for someone else's card
note	string	Free note stored on the contact
size	integer	PNG width in pixels, 32 to 4000 (default 300). SVG scales without it
email	string	Email address. Defaults to the shared business profile
phone	string	Phone number, in the form it should be dialled. Defaults to the shared business profile
title	string	Job title
format	string	svg (default, free) or png (Pro)
margin	integer

qr_wifi

Call this tool to make a QR code that joins a WiFi network when scanned: ssid, password and auth type, written to out_path or returned as SVG. Free: 20 codes a month. qr_create takes plain text or a URL.

Argument	Type	Description
auth	string	WPA (default when a password is given), WEP, or nopass for an open network
size	integer	PNG width in pixels, 32 to 4000 (default 300). SVG scales without it
ssid*	string	Network name, exactly as it appears
format	string	svg (default, free) or png (Pro)
hidden	boolean	True if the network does not broadcast its name
margin	integer	Quiet zone in modules, default 4, which is what the QR standard requires
out_path	string	Name for the downloaded file, e.g. acme-code. SVG is returned inline when this is left out; a PNG always comes back as a download link valid for one hour
password	string	Passphrase. Leave out only for an open network
overwrite	boolean

Barcode Qr Code Sepa Payment Ean13

Try it

barcode_batch

Barcode Qr Code Sepa Payment Ean13

Try it

barcode_batch

Tools (10)