QRdx
HelpGuidesDevelopersReact librarySelf-hosting
API reference

List saved barcodes

The saved barcodes of the workspace the key or token acts on, most recently changed first.

Page through them with limit and offset; pagination.total counts every match. status=trash lists the trash.

Scope: codes:read or codes:write, for API keys and OAuth tokens alike.

GET
/barcodes

Authorization

headerAuthorizationBearer <qrdx_ followed by 40 letters and digits>

An API key, sent as Authorization: Bearer qrdx_…. Create one in Settings → API keys & apps: it is shown once. A key acts on the workspace it was created in as its creator, with their current role there, and only within its scopes, the same scopes as OAuth (each operation names the one it needs). API keys.

Query Parameters

status?string

Which barcodes: active (default) or trash

Default"active"
Value in"active""trash"
q?string

Search: titles and values contain it

Lengthlength <= 200
format?string

Only this symbology

Value in"ean13""ean8""upca""upce""code128""code39""itf14""gs1-128""datamatrix""pdf417""aztec"
folderId?string

Only this folder's barcodes; none for those in no folder

Lengthlength <= 64
limit?integer

Barcodes per page (1-100)

Range1 <= value <= 100
Default50
offset?integer

Barcodes to skip, for the next page

Range0 <= value <= 9007199254740991
Default0

Response Body

A page of barcodes

application/json
  1. response
data*array<>
pagination*
Example Request
curl -X GET 'https://api.qrdx.dev/v1/barcodes'
Example Response
{  "data": [    {      "id": "cm5barcode0spring0box0001",      "title": "Spring box",      "format": "ean13",      "formatLabel": "EAN-13",      "value": "5901234123457",      "options": {        "foreground": "#000000",        "background": "#ffffff",        "showText": true,        "barHeightMm": 23,        "quietZone": 11,        "scale": 4,        "rotation": 0      },      "folderId": null,      "imageUrl": "https://qrdx.dev/api/v1/barcode?format=ean13&data=5901234123457",      "createdAt": "2026-01-05T09:30:00.000Z",      "updatedAt": "2026-01-05T09:30:00.000Z",      "deletedAt": null,      "organizationId": null    }  ],  "pagination": {    "total": 1,    "limit": 50,    "offset": 0  }}

Last updated on

Render a barcode image from a JSON body POST

The same image as GET /barcode, with the same fields as JSON, so the value never appears in a URL or a log of one. Not cached (Cache-Control: no-store). No key needed; it shares the 300 requests a minute per IP address with GET.

Save a barcode POST

Saves a static barcode to the workspace, listed under Barcodes in the dashboard.