Rapporter

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "selected",
    "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
    "period": "weekly",
    "format": "json",
    "timezone": "America/New_York"
  }'

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scope": "all", "period": "monthly", "format": "pdf", "locale": "de" }' \
  --output report.pdf

{
  "periodStart": "2026-08-10",
  "periodEnd": "2026-08-17",
  "qrs": [
    {
      "qrId": "clw3n7t1x0002ab0d5mqe8pkr",
      "name": "Landing page",
      "type": "website",
      "totalScans": 128,
      "uniqueScans": 96,
      "topGeography": "US",
      "topDevice": "Mobile",
      "topOs": "iOS",
      "topBrowser": "Safari"
    }
  ]
}

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "selected",
    "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
    "period": "weekly",
    "format": "json",
    "timezone": "America/New_York"
  }'

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scope": "all", "period": "monthly", "format": "pdf", "locale": "de" }' \
  --output report.pdf

{
  "periodStart": "2026-08-10",
  "periodEnd": "2026-08-17",
  "qrs": [
    {
      "qrId": "clw3n7t1x0002ab0d5mqe8pkr",
      "name": "Landing page",
      "type": "website",
      "totalScans": 128,
      "uniqueScans": 96,
      "topGeography": "US",
      "topDevice": "Mobile",
      "topOs": "iOS",
      "topBrowser": "Safari"
    }
  ]
}

GetQR API-et er i beta og er tilgjengelig for utvalgte arbeidsområder. Detaljer kan endres før den generelle lanseringen.

Rapporter oppsummerer skanninger per QR-kode for en avsluttet dag, uke eller måned. Eksporter en rapport med en gang, eller planlegg en rapport som sendes på e-post med jevne mellomrom.

Metode	Bane	Beskrivelse
`POST`	`/api/v1/reports`	Eksporter en rapport
`GET`	`/api/v1/reports/schedules`	Vis planlagte rapporter
`POST`	`/api/v1/reports/schedules`	Planlegg en rapport
`PATCH`	`/api/v1/reports/schedules/{id}`	Oppdater en planlagt rapport
`DELETE`	`/api/v1/reports/schedules/{id}`	Slett en planlagt rapport

Headere

string

påkrevd

Bearer etterfulgt av API-nøkkelen din. Se Autentisering.

string

application/json. Påkrevd ved POST- og PATCH-forespørsler.

Omfang

Både enkeltstående og planlagte rapporter tar et scope:

`scope`	Dekker	`qrIds`
`all`	QR-kodene i arbeidsområdet ditt	Utelat
`selected`	Et utvalg QR-koder	Én eller flere ID-er
`single`	Nøyaktig én QR-kode	Nøyaktig én ID

En rapport viser maksimalt 50 QR-koder. Med all er det de sist opprettede aktive QR-kodene; koder som er satt på pause, utelates. Med selected og single tas koder som er satt på pause, med. QR-koder uten kortlenke har ingen skanninger og hoppes over.

Periode

Perioden er alltid den siste avsluttede, så en rapport inneholder aldri delvise data fra i dag. Grensene er midnatt i rapportens tidssone.

`period` eller `frequency`	Dekker
`daily`	Forrige dag
`weekly`	Forrige uke, mandag til søndag
`monthly`	Forrige kalendermåned

Eksporter en rapport

POST /api/v1/reports Bygger en rapport for den siste avsluttede perioden og returnerer den i svaret.

string

påkrevd

all, selected eller single. Se Omfang.

string

påkrevd

daily, weekly eller monthly. Se Periode.

string

påkrevd

json returnerer rapporten i svarets body. csv og pdf returnerer en fil som lastes ned.

string[]

QR-kodene rapporten skal dekke. Påkrevd for selected (én eller flere ID-er) og single (nøyaktig én ID). Utelat den for all.

string

standard:"UTC"

IANA-tidssone som periodegrensene justeres etter, for eksempel America/New_York. En ukjent tidssone returnerer 422.

string

standard:"en"

Språket i PDF-en, for eksempel en eller de. En verdi som ikke støttes, faller tilbake til engelsk. Ignoreres av csv og json.

string

Tittel som vises på PDF-en, opptil 40 tegn. Ignoreres av csv og json.

JSON-svar

string

Første dag i perioden, YYYY-MM-DD.

string

Første dag etter perioden, YYYY-MM-DD. Perioden slutter ved midnatt i starten av denne dagen.

object[]

Én oppføring per QR-kode.

Vis properties

string

ID-en til QR-koden.

string

Tittelen på QR-koden, eller Untitled QR.

string

QR-kodetype, for eksempel website.

integer

Totalt antall skanninger i perioden.

integer

Unike skanninger i perioden.

string

Landkoden med flest skanninger, eller — uten skanninger.

string

Enheten med flest skanninger, eller —.

string

Operativsystemet med flest skanninger, eller —.

string

Nettleseren med flest skanninger, eller —.

CSV- og PDF-svar

Body er filen. Content-Disposition gir den navn etter perioden, for eksempel report-2026-08-10_2026-08-17.csv. CSV-filen har én rad per QR-kode med kolonnene QR ID, QR name, QR type, Total scans, Unique scans, Top geography, Top device, Top OS og Top browser.

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "selected",
    "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
    "period": "weekly",
    "format": "json",
    "timezone": "America/New_York"
  }'

curl -X POST "https://getqr.com/api/v1/reports" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scope": "all", "period": "monthly", "format": "pdf", "locale": "de" }' \
  --output report.pdf

{
  "periodStart": "2026-08-10",
  "periodEnd": "2026-08-17",
  "qrs": [
    {
      "qrId": "clw3n7t1x0002ab0d5mqe8pkr",
      "name": "Landing page",
      "type": "website",
      "totalScans": 128,
      "uniqueScans": 96,
      "topGeography": "US",
      "topDevice": "Mobile",
      "topOs": "iOS",
      "topBrowser": "Safari"
    }
  ]
}

Objektet for planlagt rapport

En planlagt rapport sendes på e-post til kontoen som opprettet den, ved midnatt i rapportens tidssone.

string

ID-en til den planlagte rapporten.

string | null

Etikett som vises i emnet på e-posten og i dashbordet.

string

daily, weekly eller monthly.

string

all, selected eller single.

string[] | null

QR-kodene rapporten dekker med omfangene selected og single. null når ingen ID-er ble sendt.

null

Alltid null. Reservert.

boolean

Om en PDF legges ved e-posten.

string

active eller paused.

string

IANA-tidssone som sendetidspunktet og perioden justeres etter.

string

Språket i e-posten og PDF-en.

string

Når neste e-post skal sendes, ISO 8601: neste midnatt (daily), neste mandag (weekly) eller den 1. i neste måned (monthly), i rapportens tidssone.

string | null

Når siste e-post ble sendt, ISO 8601.

string

Opprettelsesdato, ISO 8601.

string

Dato for siste oppdatering, ISO 8601.

Vis planlagte rapporter

GET /api/v1/reports/schedules Returnerer de planlagte rapportene i arbeidsområdet ditt, også de som andre medlemmer har opprettet, med de nyeste først. Listen er paginert: se Paginering.

integer

standard:"1"

Siden som skal returneres, 1 eller høyere.

integer

standard:"100"

Resultater per side, 1 til 100.

curl "https://getqr.com/api/v1/reports/schedules?page=1&pageSize=100" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "data": [
    {
      "id": "clx8f2k9a0001qk0c8vhd3xyz",
      "name": "Weekly campaign digest",
      "frequency": "weekly",
      "scope": "selected",
      "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr", "clw3n7t1x0004ab0d9rzu2wfh"],
      "filters": null,
      "includePdf": true,
      "status": "active",
      "timezone": "America/New_York",
      "locale": "en",
      "nextRunAt": "2026-08-10T04:00:00.000Z",
      "lastRunAt": "2026-08-03T04:00:12.000Z",
      "createdAt": "2026-07-01T12:34:56.000Z",
      "updatedAt": "2026-07-28T09:12:00.000Z"
    }
  ],
  "pagination": { "page": 1, "pageSize": 100, "total": 1, "hasMore": false }
}

Planlegg en rapport

POST /api/v1/reports/schedules Oppretter en rapport som sendes på e-post med jevne mellomrom. nextRunAt beregnes ut fra frekvensen og tidssonen.

En QR-kode kan bare tilhøre én planlagt rapport per frekvens. En overlappende tidsplan returnerer 409 conflict.

En rapport med omfanget all overlapper alle andre rapporter med samme frekvens. Rapporter som er satt på pause, teller også.

string

påkrevd

Hvor ofte rapporten sendes: daily, weekly eller monthly. Bestemmer også perioden den dekker. Se Periode.

string

påkrevd

all, selected eller single. Se Omfang.

string

påkrevd

IANA-tidssone som sendetidspunktet og perioden justeres etter, for eksempel America/New_York. En ukjent tidssone returnerer 422.

string

påkrevd

Språket i e-posten og PDF-en, for eksempel en eller de. En verdi som ikke støttes, faller tilbake til engelsk. PDF-er på zh, ja, ko og ar gjengis på engelsk.

string[]

QR-kodene rapporten skal dekke. Påkrevd for selected (én eller flere ID-er) og single (nøyaktig én ID). Hver ID må være en QR-kode i arbeidsområdet ditt, ellers returnerer forespørselen 404.

string

Etikett som vises i emnet på e-posten og i dashbordet, opptil 40 tegn.

boolean

standard:"false"

Legg ved en PDF-versjon av rapporten i e-posten.

curl -X POST "https://getqr.com/api/v1/reports/schedules" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Weekly campaign digest",
    "frequency": "weekly",
    "scope": "selected",
    "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
    "includePdf": true,
    "timezone": "America/New_York",
    "locale": "en"
  }'

{
  "id": "clx8f2k9a0001qk0c8vhd3xyz",
  "name": "Weekly campaign digest",
  "frequency": "weekly",
  "scope": "selected",
  "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
  "filters": null,
  "includePdf": true,
  "status": "active",
  "timezone": "America/New_York",
  "locale": "en",
  "nextRunAt": "2026-08-10T04:00:00.000Z",
  "lastRunAt": null,
  "createdAt": "2026-08-03T12:34:56.000Z",
  "updatedAt": "2026-08-03T12:34:56.000Z"
}

Oppdater en planlagt rapport

PATCH /api/v1/reports/schedules/{id} Endrer en planlagt rapport, eller setter den på pause og gjenopptar den. Send bare feltene du vil endre, minst ett. Endrer du frekvensen eller tidssonen, eller gjenopptar en rapport som er satt på pause, beregnes nextRunAt på nytt. Regelen om én rapport per frekvens gjelder fortsatt, så en overlappende endring returnerer 409.

string

påkrevd

ID-en til den planlagte rapporten. Hent den fra svaret på listen eller opprettelsen.

string

paused stopper e-postene uten å slette tidsplanen. active gjenopptar dem.

string

Etikett, opptil 40 tegn.

string

daily, weekly eller monthly.

string

all, selected eller single.

string[]

QR-kodene rapporten skal dekke. Hver ID må være en QR-kode i arbeidsområdet ditt.

boolean

Legg ved en PDF i e-posten.

string

IANA-tidssone.

string

Språket i e-posten og PDF-en.

curl -X PATCH "https://getqr.com/api/v1/reports/schedules/clx8f2k9a0001qk0c8vhd3xyz" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Monthly campaign digest",
    "frequency": "monthly",
    "status": "active"
  }'

{
  "id": "clx8f2k9a0001qk0c8vhd3xyz",
  "name": "Monthly campaign digest",
  "frequency": "monthly",
  "scope": "selected",
  "qrIds": ["clw3n7t1x0002ab0d5mqe8pkr"],
  "filters": null,
  "includePdf": true,
  "status": "active",
  "timezone": "America/New_York",
  "locale": "en",
  "nextRunAt": "2026-09-01T04:00:00.000Z",
  "lastRunAt": "2026-08-03T04:00:12.000Z",
  "createdAt": "2026-07-01T12:34:56.000Z",
  "updatedAt": "2026-08-05T10:15:00.000Z"
}

Slett en planlagt rapport

DELETE /api/v1/reports/schedules/{id} Sletter tidsplanen og stopper alle videre e-poster.

Sletting av en planlagt rapport kan ikke angres.

string

påkrevd

ID-en til den planlagte rapporten.

curl -X DELETE "https://getqr.com/api/v1/reports/schedules/clx8f2k9a0001qk0c8vhd3xyz" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{ "id": "clx8f2k9a0001qk0c8vhd3xyz", "deleted": true }

Vanlige problemer

404 når jeg eksporterer en rapport

Med omfanget selected eller single samsvarte ingen av qrIds med en QR-kode med kortlenke i arbeidsområdet ditt. Sjekk ID-ene.

404 "QR not found." når jeg planlegger en rapport

En av qrIds er ikke en QR-kode i arbeidsområdet ditt, eller den er slettet. Sjekk ID-ene med Vis QR-koder.

409 når jeg planlegger en rapport

En av QR-kodene tilhører allerede en planlagt rapport med samme frekvens, eller en rapport med den frekvensen bruker omfanget all. Rediger eller slett den rapporten, eller velg en annen frekvens.

404 "Scheduled report not found."

id samsvarer ikke med en planlagt rapport i arbeidsområdet ditt. Hent den fra Vis planlagte rapporter.

Rapporten mangler dagens skanninger

Rapporter dekker bare den siste avsluttede perioden. Bruk Analyse for tall i sanntid.

API

Headere

Omfang

Periode

Eksporter en rapport

JSON-svar

CSV- og PDF-svar

Objektet for planlagt rapport

Vis planlagte rapporter

Planlegg en rapport

Oppdater en planlagt rapport

Slett en planlagt rapport

Vanlige problemer

Neste steg

Analyse

Planlagte rapporter i appen

Les rapportene dine

Feil

​Headere

​Omfang

​Periode

​Eksporter en rapport

​JSON-svar

​CSV- og PDF-svar

​Objektet for planlagt rapport

​Vis planlagte rapporter

​Planlegg en rapport

​Oppdater en planlagt rapport

​Slett en planlagt rapport

​Vanlige problemer

​Neste steg

Analyse

Planlagte rapporter i appen

Les rapportene dine

Feil

Headere

Omfang

Periode

Eksporter en rapport

JSON-svar

CSV- og PDF-svar

Objektet for planlagt rapport

Vis planlagte rapporter

Planlegg en rapport

Oppdater en planlagt rapport

Slett en planlagt rapport

Vanlige problemer

Neste steg