Role holders for the specified account and period. Empty list if no hits.

The last chapter in this page shows what fields to include in the different DSOP Solutions based on the DSOP Control Common Standard.


Abbreviations   Description
M Mandatory Must be part of the response, even if there is no data. Not returning this field in the response can break the receiving API.
D Deliver Producers are obligated to deliver all requested data if they can*. If the data exists in the Producers systems and is possible to deliver through the API, it must be part of the response. If the data does not exist or cannot be delivered through the API, the field can be omitted.
MC Mandatory conditional - Child fields where Parent field is marked «M»(Mandatory) is crucial to give value to the Parent and must be delivered, even if there is no data. (See separate description for how to return empty or no data in fields.) Not returning this field in the response can break the receiving API.

- As long as a parent field marked with “D” is part of the response, the child field marked with “MC” must also be returned.
O Optional Only used in input parameters

*If the data provider cannot deliver all requested data through Control API, but have more data offline, responseStatus must return value “partial”.

Input parameters

Values set by data consumer.

It is the data providers responsibility to validate all requests’ from the data consumers and to make sure that all requests are validated well enough. See some recommendations regarding validation of requests in Control API.

Parameter Description Comment
accountReference (M) A unique reference to the account, but should not be the account number and not simply decoded to an account number.  
AccountInfoRequestID (M) Consumers case reference id/number Link to Specification of eOppslag
CorrelationID (M) Unique identifier for the technical request Link to Specification of eOppslag
Legal-Mandate* (M) Legal basis the financial institution should validate. Formatted encoded text. Link to Juridiske rammebetingelser
AdditionalReferenceID* (O) Reference ID when legal-mandate is not adequate alone, or to identify requester at consumer. Should be validated according to the legal-mandate. Formatted encoded text. Required for some legal mandates.
More information in Specification of eOppslag
AdditionalReferenceIDType* (O) What type of reference to expect in AdditionalReferenceID Required for some legal mandates.
More information in Specification of eOppslag
fromDate (O) From date, current date if not stated  
toDate (O) To date, current date if not stated  

*It is recommended to validate AdditionalReferenceID and AdditionalReferenceIDType according to the legal-mandate (see what legal mandates which requires information in AdditionalReferenceID). Legal-mandate should always be logged with belonging AdditionalReferenceID.


Values in response from financial institutions.

All fields are to be provided as long as the bank/financial institution holds the data, regardless of whether the fields are marked as mandatory or not. This is according to the legal basis.

Value Level 1 Level 2
responseStatus (D)    
roles (D)    
  roles.permission (D)  
  roles.identifier (D)  
    roles.identifier.countryOfResidence (D)
    roles.identifier.value (MC)
    roles.identifier.type (MC) (D)  
  roles.startDate (D)  
  roles.endDate (D)  
  roles.postaladdress (D)  
    roles.postaladdress.postCode (D)
    roles.postaladdress.type (D)
    roles.postaladdress.streetName (D)
    roles.postaladdress.buildingNumber (D)
    roles.postalAddress.townName (D) (D)
    roles.postalAddress.addressLines (D)
  roles.electronicAddress (D)  
    roles.electronicAddress.type (MC)
    roles.electronicAddress.value (MC)

Description og all response elements in the API



Indicates whether this is a complete answer, or whether there is data offline that can not be retrieved through the API.

  • partial: If there is any data in the producers systems that can be retrieved manually and is not part of the API response.
  • complete: If there are no more available data that can be retrieved manually. All known data has been returned in the response.

responseStatus is not to be used as an indicator for paginating.

[partial, complete]





Specifies the type of role/right a person or organization has for an account.

  • rightToUseAlone: Can issue transactions changing the balance of the account on its own
  • rightToUseWithOther: Can only issue transactions changing the balance of the account together with other party
  • rightToSeeOnly: Can only view account details, but not issue transactions.
[rightToUseAlone, rightToUseWithOther, rightToSeeOnly]





CountryCode. The country the person or organization belongs to. In ISO 3166-1/Alpha-2 code format.


Mandatory conditional

Birth and social security number or organization number.


Mandatory conditional

  • countryIdentificationCode: The national registration code for businesses, enterprise, organizations and companies that is retrived from the National register for organizations. In Norway this would be from BRREG.
  • nationalIdentityNumber: Used for persons. The national identitycode for persons. In Norway this would be P or D numbers from FREG.
[countryIdentificationCode, nationalIdentityNumber]


Name of the person or organization has the role on the account.



Start date for when party got the account role. This is the last period to be specified if the account rights has been lost then re-gained. ISODate (yyyy-mm-dd).



End date for when the party lost their rights on the account. This is the last period to be specified if the account rights has been lost then re-gained. No end date if the party still have right to the account. ISODate (yyyy-mm-dd).



The address of the party who owns the account.



Registered postalcode for the role holders address.



Type of registered address for the role holder.

[residential, business, mailTo, deliveryTo]



Street address registered on the role holder.



Buildingnumber for the street address registered on the role holder.



Postalcode location name, reffering to the Postalcode and street address for the role holder.


Country code for the registered address of the role holder. countryCode In ISO 3166-1/Alpha-2 code format.



Additional address information, freetext.




Mandatory conditional

[phoneNumber, emailAddress]


Mandatory conditional

Registered phone number or e-mailaddress for primary owner, if any. Any format. Phonenumber may start with country suffix.

Use of the data model per DSOP solution

The table below shows what fields to include in the different DSOP Solutions.

Field Kontrollinformasjon (Skatteetaten, NAV, Politi) Konkursbehandling (Brreg)
responseStatus (D) N/A
roles (D) N/A
roles.permission (D) N/A
roles.identifier (D) N/A
roles.identifier.countryOfResidence (D) N/A
roles.identifier.value (MC) N/A
roles.identifier.type (MC) N/A (D) N/A
roles.startDate (D) N/A
roles.endDate (D) N/A
roles.postaladdress (D) N/A
roles.postaladdress.postCode (D) N/A
roles.postaladdress.type (D) N/A
roles.postaladdress.streetName (D) N/A
roles.postaladdress.buildingNumber (D) N/A
roles.postalAddress.townName (D) N/A (D) N/A
roles.postalAddress.addressLines (D) N/A
roles.electronicAddress (D) N/A
roles.electronicAddress.type (MC) N/A
roles.electronicAddress.value (MC) N/A

Change log

Date Change Link in document
23.10.20 Specified that AdditionalReferenceID must be formatted encoded text Input parameters
  V.1.1 is current version