External API

API for the external to get system user information

Verify Party Integration

Validates whether the organization requesting a token from Machineporten has a system user associated with the specified credentials. For a detailed description of the response model, please refer to this link

Endpoint

GET authentication/api/v1/systemuser/byExternalId?clientid=&systemproviderorgno=&systemuserownerorgno=&externalref=

Scopes

Machineporten token with scope altinn:maskinporten/systemuser.read

Content types

application/json

Query Parameters

clientid

The client id credential from the machineporten integration

systemproviderorgno

The organization number of the system vendor

systemownerorgno

The organisation numner of the system user

externalref

The external reference provided by the system vendor in the system user request. This is an optional parameter and defaults to system user organisation number.

Example Response

{
    "id": "704013ee-e82a-433e-83c5-a40e6e00d746",
    "integrationTitle": "SmartCloud",
    "systemId": "991825827_smartcloud",
    "productName": "991825827_smartcloud",
    "systemInternalId": "6eeac941-8685-49ad-a195-e60542e72d45",
    "partyId": "51655537",
    "reporteeOrgNo": "313775429",
    "created": "2024-11-15T09:36:50.451886Z",
    "isDeleted": false,
    "supplierName": "",
    "supplierOrgno": "991825827",
    "externalRef": "313775429"
}

List all system users for a system

Endpoint

GET authentication/api/v1/systemuser/vendor/bysystem/{systemId}

Scopes

Machineporten token with scope altinn:authentication/systemregister.write

Content types

application/json

Query Parameters

systemid

The unique identifier of the registered system

Example Response

{
    "links": {},
    "data": [
        {
            "id": "704013ee-e82a-433e-83c5-a40e6e00d746",
            "integrationTitle": "SmartCloud",
            "systemId": "991825827_smartcloud",
            "productName": "",
            "systemInternalId": "6eeac941-8685-49ad-a195-e60542e72d45",
            "partyId": "51655537",
            "reporteeOrgNo": "313775429",
            "created": "2024-11-15T09:36:50.451886Z",
            "isDeleted": false,
            "supplierName": "",
            "supplierOrgno": "991825827",
            "externalRef": "313775429",
            "accessPackages": [],
            "userType": "standard"
        },
        {
            "id": "6ad176d8-2a88-4c24-a1db-339d52697d5f",
            "integrationTitle": "SmartCloud",
            "systemId": "991825827_smartcloud",
            "productName": "",
            "systemInternalId": "6eeac941-8685-49ad-a195-e60542e72d45",
            "partyId": "51600138",
            "reporteeOrgNo": "312975955",
            "created": "2024-11-15T09:44:51.572594Z",
            "isDeleted": false,
            "supplierName": "",
            "supplierOrgno": "991825827",
            "externalRef": "312975955",
            "accessPackages": [],
            "userType": "standard"
        },
        {
            "id": "6c9a7dd0-2f27-4a99-9504-17b36ccba329",
            "integrationTitle": "SmartCloud",
            "systemId": "991825827_smartcloud",
            "productName": "",
            "systemInternalId": "6eeac941-8685-49ad-a195-e60542e72d45",
            "partyId": "51383399",
            "reporteeOrgNo": "310816191",
            "created": "2024-11-15T09:50:13.371834Z",
            "isDeleted": false,
            "supplierName": "",
            "supplierOrgno": "991825827",
            "externalRef": "310816191",
            "accessPackages": [],
            "userType": "standard"
        },
        {
            "id": "5b5614b4-2ed8-4f57-960f-fa5738af097b",
            "integrationTitle": "SmartCloud",
            "systemId": "991825827_smartcloud",
            "productName": "",
            "systemInternalId": "6eeac941-8685-49ad-a195-e60542e72d45",
            "partyId": "51256036",
            "reporteeOrgNo": "313641341",
            "created": "2024-11-15T09:59:15.375737Z",
            "isDeleted": false,
            "supplierName": "",
            "supplierOrgno": "991825827",
            "externalRef": "313641341",
            "accessPackages": [],
            "userType": "standard"
        },
        {
            "id": "c207c84b-e092-4360-a375-d68645d1bfda",
            "integrationTitle": "SmartCloud",
            "systemId": "991825827_smartcloud",
            "productName": "",
            "systemInternalId": "6eeac941-8685-49ad-a195-e60542e72d45",
            "partyId": "51568851",
            "reporteeOrgNo": "312530341",
            "created": "2024-11-18T09:24:43.561465Z",
            "isDeleted": false,
            "supplierName": "",
            "supplierOrgno": "991825827",
            "externalRef": "312530341",
            "accessPackages": [],
            "userType": "standard"
        },
        {
            "id": "f693fdde-14f3-46ad-a44f-ad19f34026dd",
            "integrationTitle": "SmartCloud",
            "systemId": "991825827_smartcloud",
            "productName": "",
            "systemInternalId": "6eeac941-8685-49ad-a195-e60542e72d45",
            "partyId": "51295426",
            "reporteeOrgNo": "314048431",
            "created": "2024-11-15T09:22:50.766297Z",
            "isDeleted": false,
            "supplierName": "",
            "supplierOrgno": "991825827",
            "externalRef": "12345qwerty",
            "accessPackages": [],
            "userType": "standard"
        },
        {
            "id": "3be574de-3c7e-4aea-a399-1102b28a7a8f",
            "integrationTitle": "SmartCloud",
            "systemId": "991825827_smartcloud",
            "productName": "",
            "systemInternalId": "6eeac941-8685-49ad-a195-e60542e72d45",
            "partyId": "51381826",
            "reporteeOrgNo": "310798274",
            "created": "2024-10-10T06:56:06.790755Z",
            "isDeleted": false,
            "supplierName": "",
            "supplierOrgno": "991825827",
            "externalRef": "310798274",
            "accessPackages": [],
            "userType": "standard"
        },
        {
            "id": "a00b8bc6-4eb2-4a89-aea2-b7e62450eb7c",
            "integrationTitle": "SmartCloud",
            "systemId": "991825827_smartcloud",
            "productName": "",
            "systemInternalId": "6eeac941-8685-49ad-a195-e60542e72d45",
            "partyId": "51510360",
            "reporteeOrgNo": "312976749",
            "created": "2024-10-10T06:57:29.495078Z",
            "isDeleted": false,
            "supplierName": "",
            "supplierOrgno": "991825827",
            "externalRef": "312976749",
            "accessPackages": [],
            "userType": "standard"
        },
        {
            "id": "7eeb775c-1e58-4f6c-a79f-e79b4b148295",
            "integrationTitle": "SmartCloud",
            "systemId": "991825827_smartcloud",
            "productName": "",
            "systemInternalId": "6eeac941-8685-49ad-a195-e60542e72d45",
            "partyId": "51584261",
            "reporteeOrgNo": "312750481",
            "created": "2024-10-14T05:14:22.9004Z",
            "isDeleted": false,
            "supplierName": "",
            "supplierOrgno": "991825827",
            "externalRef": "312750481",
            "accessPackages": [],
            "userType": "standard"
        },
        {
            "id": "682bc674-5847-4fbf-b8f8-e69f90e4750f",
            "integrationTitle": "SmartCloud",
            "systemId": "991825827_smartcloud",
            "productName": "",
            "systemInternalId": "6eeac941-8685-49ad-a195-e60542e72d45",
            "partyId": "51295426",
            "reporteeOrgNo": "314048431",
            "created": "2024-11-15T09:33:13.774495Z",
            "isDeleted": false,
            "supplierName": "",
            "supplierOrgno": "991825827",
            "externalRef": "314048431",
            "accessPackages": [],
            "userType": "standard"
        }
    ]
}