QRdx
HelpGuidesDevelopersReact librarySelf-hosting

List codes

The dynamic codes of the token owner's personal workspace, newest first.

Page through them with limit and offset; pagination.total counts every match.

GET
/codes

Authorization

oauth2 codes:read
headerAuthorizationBearer <token>

An OAuth 2.0 access token, sent as Authorization: Bearer <token>. Register an app in Settings → Developers, send the user through authorization (PKCE S256), then exchange the code for a token. Access tokens last 1 hour; refresh tokens 30 days. Step by step.

Scope: codes:read

Query Parameters

status?string

Which codes: active (default), archived or all

Default"active"
Value in"active""archived""all"
q?string

Search: titles, destinations, notes and tags contain it, or it is the exact back-half or short link

Lengthlength <= 200
limit?integer

Codes per page (1–100)

Range1 <= value <= 100
Default50
offset?integer

Codes to skip, for the next page

Range0 <= value <= 100000
Default0

Response Body

A page of codes

application/json
  1. response
data*array<>
pagination*
Example Request
curl -X GET 'https://api.qrdx.dev/v1/codes'
Example Response
{  "data": [    {      "id": "cm5code0spring0menu00001",      "slug": "aB3dE5f",      "shortLink": "https://qrdx.dev/q/aB3dE5f",      "defaultShortLink": "https://qrdx.dev/q/aB3dE5f",      "domain": null,      "destinationUrl": "https://example.com/menu",      "title": "Spring menu",      "contentType": "url",      "status": "active",      "style": {        "fgColor": "#111827",        "bgColor": "#ffffff",        "bodyPattern": "circle",        "cornerEyePattern": "rounded",        "level": "Q"      },      "scanCount": 128,      "lastScannedAt": "2026-01-12T18:04:11.000Z",      "archivedAt": null,      "createdAt": "2026-01-05T09:30:00.000Z",      "updatedAt": "2026-01-05T09:30:00.000Z",      "organizationId": null    }  ],  "pagination": {    "total": 1,    "limit": 50,    "offset": 0  }}

Last updated on