Last modified: May 5, 2023

Query app events as application owner

Developer guide on how to query app events as an application owner

On this page:

Altinn Events enables event driven integration patterns, designed specifically to avoid the need for continuously requesting resources, also known as ‘polling’.

However, in order to allow for smooth and incremental architectural migrations, the Events API also provides an HTTP API for scheduled requests of the same event data you hopefully will receive via webhooks in the future.


GET /app/{org}/{app}

where {org}/{app} makes up the application ID for the app resource you want to retrieve events for.


This API requires authentication.

See Authentication and Authorization for more information.


Query parameters & headers


  • ID of the event last retrieved, type: string

Result set will include events registered after the provided event ID in chronological order


  • the lower limit for when the cloud event was registered in UTC, type: string(date-time)

Accepted format is 2023-02-16T18:00Z


  • the upper limit for when the cloud event was registered in UTC, type: string(date-time)

Accepted format is 2023-02-16T18:00Z


  • the party ID representing the subject of the cloud event


  • the organisation number representing the unit in the cloud event’s alternative subject

person (header)

  • the person number representing the person in the cloud event’s alternative subject


  • the event types to include, type: array[string]


  • size of the result set, type: string

Default size is set to 50 events


Contains a header next to be used to retrieve a new set of events following the final event in the result set. Next header is returned regardless if there exists more events to be retrieved or not.

Supported content-types


Response codes

  • 200 OK: Events matching query set are returned
  • 400 Bad Request: Invalid set of query parameters Refer to problem details in response body for further information.
  • 401 Unauthorized: Indicates a missing, invalid or expired authorization header



curl \
--location '' \
--header 'Authorization: Bearer {Insert Altinn token}'


200 OK

If the result set contains events that you are authorized to receive, the response object will look like below, if no events match your query or you aren’t authorized to read the event, and empty array ‘[]’ will be returned.


Content-Type: application/cloudevents+json; charset=utf-8


		"specversion": "1.0",
		"id": "cf7577ad-7ae6-498f-bc48-0704bd895b41",
		"time": "2023-02-16T18:02:11.0276259Z",
		"source": "",
		"subject": "/party/50019855",
		"type": "app.instance.created",
		"alternativesubject": "/person/16035001577"
		"specversion": "1.0",
		"id": "fc12dc69-fcd4-43c6-9fde-b94fcdcc3597",
		"time": "2023-02-16T18:02:12.8660282Z",
		"source": "",
		"subject": "/party/50019855",
		"type": "app.instance.process.completed",
		"alternativesubject": "/person/16035001577"

400 Bad Request

Response contains a problem details object with the error message listed within the errors property.

    "type": "",
    "title": "Bad Request",
    "status": 400,
    "detail": "The 'From' or 'After' parameter must be defined.",
    "traceId": "00-f4b14cafa151f01e81d227de85be4c89-f13652f55cdfaa7e-00"