Last modified: Apr 16, 2025

Get system information from system register

API for the vendor to get system information from the system register

Get a system

Retrieves a system by the system id

Endpoint

GET authentication/api/v1/systemregister/vendor/{systemId}

Scopes

Machineporten token with scope altinn:authentication/systemregister.write

Content types

application/json

Arguments

systemId

The id should be in the format of {systemvendororgno}_{name chosen by the vendor}. F.example “310547891_testproduct”. This is a unique id to identify the product.

Example of Response Model

{
    "id": "312605031_b217b2f5-362f-4aa2-b919-ceaeaf9f15a1",
    "vendor": {
        "ID": "0192:312605031"
    },
    "name": {
        "en": "Integrationb217b2f5-362f-4aa2-b919-ceaeaf9f15a1",
        "nb": "IntegrationTestb217b2f5-362f-4aa2-b919-ceaeaf9f15a1",
        "nn": "IntegrationTestNynorskb217b2f5-362f-4aa2-b919-ceaeaf9f15a1"
    },
    "description": {
        "en": "This is auto generated by an integration test. Some data is randomized, but some is not - like this description",
        "nb": "Integrasjonstest. Noe er randomisert her, men mye blir likt.",
        "nn": "integrasjonstest på nynorsk. Noe er randomisert her, men mye blir likt."
    },
    "rights": [
        {
            "resource": [
                {
                    "id": "urn:altinn:resource",
                    "value": "authentication-e2e-test"
                },
                {
                    "id": "urn:altinn:resource",
                    "value": "authentication-e2e-test"
                }
            ]
        }
    ],
    "accessPackages": [],
    "isDeleted": true,
    "clientId": [
        "a8be01d2-30b9-443e-98ce-4c09b0a0ad00"
    ],
    "isVisible": false,
    "allowedRedirectUrls": [
        "https://altinn.no/"
    ]
}

Get Rights of a system

Get the rights defined for a system. This is an open api.

Endpoint

GET authentication/api/v1/systemregister/vendor/{systemId}/rights

Scopes

No authentication required

Content types

application/json

Arguments

systemId

The id should be in the format of {systemvendororgno}_{name chosen by the vendor}. F.example “310547891_testproduct”. This is a unique id to identify the product.

Example of Response Model

[
    {
        "resource": [
            {
                "id": "urn:altinn:resource",
                "value": "authentication-e2e-test"
            },
            {
                "id": "urn:altinn:resource",
                "value": "authentication-e2e-test"
            }
        ]
    }
]

Get AccessPackages of a system

Get the accesspackages defined for a system. This is an open api.

Endpoint

GET authentication/api/v1/systemregister/{systemId}/accesspackages

Scopes

No authentication required

Content types

application/json

Arguments

systemId

The id should be in the format of {systemvendororgno}_{name chosen by the vendor}. F.example “310547891_testproduct”. This is a unique id to identify the product.

Example of Response Model

[
    {
        "urn": "urn:altinn:accesspackage:revisormedarbeider"
    },
    {
        "urn": "urn:altinn:accesspackage:ansvarlig-revisor"
    }
]