Pular para o conteúdo

Listar códigos

GET/v1/codes

Parâmetros da consulta

limitnumberopcionalTamanho da página, de 1 a 100. Padrão 25.
cursorstringopcionalnextCursor da página anterior.
folderIdstringopcionalSó os códigos desta pasta.
typestringopcionalSó um tipo de código, por exemplo url.
statusstringopcionalactive, paused, expired, scan_limit_reached ou disabled.
dynamicbooleanopcionaltrue ou false.
searchstringopcionalCombina com o nome e o slug.
sortstringopcionalcreated_at, updated_at, name ou scans; prefixo - para decrescente. Padrão -created_at.

Exemplo de requisição

requisiçãoGET /v1/codes
curl "https://api.dotwick.com/v1/codes?folderId=fld_8k2m4q7x&status=active&limit=50" \  -H "Authorization: Bearer sk_live_…"
resposta200 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"}

Mais páginas

Quando nextCursor não é null, passe-o como cursor para obter a próxima página. Uma chave restrita a pastas só vê os códigos dentro delas. As contagens de escaneamentos podem atrasar alguns segundos em relação aos endpoints de estatísticas.