Listar códigos
GET/v1/codes
Parámetros de consulta
limitnumberopcionalTamaño de página, de 1 a 100. Por defecto 25.cursorstringopcionalnextCursor de la página anterior.folderIdstringopcionalSolo los códigos de esta carpeta.typestringopcionalSolo un tipo de código, p. ej. url.statusstringopcionalactive, paused, expired, scan_limit_reached o disabled.dynamicbooleanopcionaltrue o false.searchstringopcionalCoincide con el nombre y el slug.sortstringopcionalcreated_at, updated_at, name o scans; añade el prefijo - para orden descendente. Por defecto -created_at.Solicitud de ejemplo
solicitudGET /v1/codes
curl "https://api.dotwick.com/v1/codes?folderId=fld_8k2m4q7x&status=active&limit=50" \ -H "Authorization: Bearer sk_live_…"respuesta200 OK
{ "data": [ { "id": "qr_8841ce2mxk", "workspaceId": "ws_8f21ac4e9d0b7c11", "name": "Van fleet – unit 14", "type": "url", "dynamic": true, "status": "active", "slug": "Xq7mK2p", "domainId": null, "shortUrl": "https://dotwick.co/Xq7mK2p", "content": { "type": "url", "url": "https://example.com/fleet/van-014" }, "design": { "pattern": "rounded", "eyes": { "frame": "circle", "ball": "circle" }, "colors": { "fg": "#18181B", "bg": "#FFFFFF" } }, "rules": { "routes": [], "expiresAt": null, "scanLimit": null, "inactiveUrl": null, "passwordProtected": false }, "folderId": "fld_8k2m4q7x", "templateId": null, "createdBy": "u8Hk2LmN0pQ4rS6tV8wX0yZ2aB4cD6eF", "createdAt": "2026-09-10T09:41:08.000Z", "updatedAt": "2026-09-10T09:41:08.000Z", "scans": 1284 } ], "nextCursor": "eyJ0IjoxNzU3NDk2ODY4fQ"}Más páginas
Cuando nextCursor no es null, pásalo como cursor para obtener la página siguiente. Una clave restringida a carpetas solo ve los códigos que hay en ellas. Los recuentos de escaneos pueden ir unos segundos por detrás de los endpoints de estadísticas.