Sist endret: 22. mai 2026

List alle samtykkehendelser

Forutsetning

  1. Datakonsumenten må ha en registrert Maskinporten-klient.
  2. Datakonsumenten må ha fått delegert samtykkescope fra Digdir (altinn:consentrequests.read).
  3. De nødvendige scopene må legges til Maskinporten-klienten.

API Endepunkt

Returnerer en paginert liste over samtykkehendelser for den autentiserte virksomheten. Resultatene er sortert etter eventid, eldste først. Som standard returnerer API-et opptil 100 endringer per forespørsel. Dette endepunktet bruker kursor-basert paginering, så kall endepunktet uten en ContinuationToken for å hente den første siden.

  • Test: GET https://platform.tt02.altinn.no/accessmanagement/api/v1/enterprise/consentrequests/events
  • Produksjon: GET https://platform.altinn.no/accessmanagement/api/v1/enterprise/consentrequests/events

Spørringsparametere

ParameterTypePåkrevdBeskrivelse
ContinuationTokenstringNeiopaque-kursor fra nextLink i en tidligere respons. Brukes til paginering.
createdAfterDatetimeoffsetNeiFiltrerer hendelser opprettet på eller etter dette tidspunktet.
createdBeforeDatetimeoffsetNeiFiltrerer hendelser opprettet før dette tidspunktet.
EventTypestring[]NeiFiltrerer etter hendelsestype. Kan gjentas: eventType=accepted&eventType=revoked.
ConsentRequestIDGuidNeiFiltrerer hendelser som tilhører en bestemt samtykkeforespørsel.

Merk: createdAfter må være strengt mindre enn createdBefore hvis begge er oppgitt.

Paginering

  • Resultatene er sortert med eldste først (stigende etter hendelses-ID, som er en UUIDv7 og dermed tidssortert).
  • Kun hendelser opprettet for mer enn 5 minutter siden returneres for å sikre konsistens.
  • Sidestørrelsen er 100.
  • Hvis en nextLink finnes i responsen, følg den for å hente neste side. En nextLink kan forekomme selv når neste side er tom.
  • ContinuationToken er en Base64-kodet UUIDv7 GUID (16-byte UUID).

Request/Response Eksempel

Første side GET https://platform.tt02.altinn.no/accessmanagement/api/v1/enterprise/consentrequests/events

Authorization: Bearer <maskinporten_token>

{
  "links": {
    "next": "https://<host>/accessmanagement/api/v1/enterprise/consentrequests/events?continuationToken=MjAyNS0wNS0wNFQxMDozMDowMCswMjowMHwzZmE4NWY2NC01NzE3LTQ1NjItYjNmYy0yYzk2M2Y2NmFmYTY%3D"
  },
  "data": [
    {
      "consentRequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "eventType": "accepted",
      "changedDate": "2025-05-04T10:30:00+02:00"
    }
  ]
}

Neste side GET /accessmanagement/api/v1/enterprise/consentrequests/events?continuationToken=MjAyNS0wNS0wNFQxMDozMDowMCswMjowMHwzZmE4NWY2NC01NzE3LTQ1NjItYjNmYy0yYzk2M2Y2NmFmYTY%3D

Authorization: Bearer <maskinporten_token>

{
  "links": {
    "next": "https://<host>/accessmanagement/api/v1/enterprise/consentrequests/events?continuationToken=MjAyNS0wNS0wNFQxMDozMDowMCswMjowMHwzZmE4NWY2NC01NzE3LTQ1NjItYjNmYy0yYzk2M2Y2NmFmYTY%3D"
  },
  "data": [
    {
      "consentRequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "eventType": "accepted",
      "changedDate": "2025-05-04T10:30:00+02:00"
    }
  ]
}

Responsfelter

ResponsfeltTypeBeskrivelse
data[].consentRequestIdGuidID-en til samtykkeforespørselen som denne hendelsen tilhører.
data[].eventTypestringTypen statushendelse. Hendelser: accepted, rejected, revoked, deleted, used.
data[].changedDateDatetimeoffsetTidspunktet for når statusendringen skjedde.
links.nextURL for å hente neste side.

Next

Finnes kun når flere resultater er tilgjengelige. Bruk URL-en som den er for å hente neste side. De opprinnelige filterparameterne (ConsentRequestID, createdAfter, createdBefore, EventType) bevares i next-lenken.

Hendelsestyper

VerdiBeskrivelse
acceptedSamtykkeforespørselen ble akseptert av samtykkeparten.
rejectedSamtykket ble avvist.
revokedSamtykket ble trukket tilbake.
deletedSamtykkeforespørselen ble slettet.
usedSamtykket ble brukt/konsumert.

Error Responses

StatuskodeBeskrivelse
401 UnauthorizedManglende eller ugyldig autentiseringstoken.
403 ForbiddenDen autentiserte parten har ikke tilgang.
400 Bad RequestSpørringsparametere er ugyldige. Se innholdet i ProblemDetails for detaljer.
500 Internal Server ErrorUventet feil på serversiden.