Contents
Table of Contents |
---|
API documentation
See Organization API documentation for detailed documentation.
See also the Organization API expands overview.
The following dataset is offered:
...
How to query the resource
Specify the organization
Use either the organizationNumber parameter or the dunsNumber parameter.
Using the "expand" parameter
By default, only a basic dataset with key information elements is returned. To select more data, the expand parameter must be provided in the request. Se Organization API expand parameter documentation.
Example
/organization/?expands=address,officialRoles,links.reports.aml | request address, official roles, and link to AML PDF report |
Response elements
Information | JSON path | Details |
---|---|---|
Key Information | keyInformation | (delivered by default)
|
...
Information | Details |
---|---|
Certificate of registration | JSON or PDF |
Addresses |
|
...
Possible additional data that you can choose
To query additional details, a client must declare this explicitly as part of the request by usage of the "expand" parameter. Se API documentation for further details.
| ||
LEI number | keyInformation.lei | |
Addresses | address |
|
Financials: Accounting | financials.accounting | Last tree years |
Financials: Key figures | financials.keyFigures | Share capital, turnover, operating profit, equity, earnings, sources, accounting years |
Financials: Auditor | financials.auditor | Name, org number, sources |
Financials: Credit | financials.credit | Rating AAA etc. |
Financials: Credit history | financials.credit.historical | Last tree years |
Financials: Accountant | ||
Financials: Credit | Rating AAA etc. | |
Lei financials.accountant | Name, org number | |
Ownership: Beneficials | ownership.beneficials | Name, address, owner share, date of birth, roles |
Ownership: Subsidiaries | ownership.subsidiaries | name, org number, percentage (owned by the company) |
Ownership: Shareholders | ownership.shareholders | name, org number, percentage, type (organization or person) |
AuthoritiesAuthorizations | authorities | Here you will find: signature rights and power of procuration. |
Official Roles | officialRoles | Roles delivered: CEO, chairman, deputy chairman, proprietor, board members, deputy board members, contact person, company secretary, representative foreign entity, trustee |
Sanction | sanction | Status, message (if no hit), matchIndicator, matchIndicatorDescription, aliasList, address, source (listname), data provider (source) Initial date, LastUpdate |
PDF Reports:
| links.reports | Note: Credit report is planed for future release. |
Note |
---|
The following expand arguments are present in the API docs, but they are currently not supported until the associated functionality becomes available in a future release.
|
Info | ||
---|---|---|
| ||
Note that if a particular response element is requested (typically through expand parameter), but no information could be found in the source, and an empty JSON node is returned to dictate that a search has been done. |
Interpreting the "authorities" response
Anchor | ||||
---|---|---|---|---|
|
The "authorities" node delivers both
- a human readable description of the company's signature rights and power of procuration
- and, for a wide range of cases, a machine readable specification of the same information
Code Block | ||||
---|---|---|---|---|
| ||||
"authorities": {
"signatureRights": {
"status": "CONCLUSIVE",
"description": "Daglig leder alene. Styrets leder alene.",
"options": [
{
"required": [
{
"name": "Lars Leder",
"dateOfBirth": "1962-02-13",
"role": "CEO"
}
]
},
{
"required": [
{
"name": "Siri Hansen",
"dateOfBirth": "1973-04-01",
"role": "CHAIRMAN_OF_THE_BOARD"
}
]
}
]
},
"powerOfProcuration": {
"status": "NOT_SET"
}
} |
Code Block | ||||
---|---|---|---|---|
| ||||
"authorities": {
"signatureRights": {
"status": "IN_CONCLUSIVE",
"description": "To styremedlemmer i fellesskap. Daglig leder alene. Styrets leder alene."
},
"powerOfProcuration": {
"status": "NOT_SET"
}
} |
The "description" element in the response contains the full natural language description of the signature rights, unchanged and on the same format as written in the "Brønnøysundregisteret" data source.
In many cases, the BankID AML service manages to express the same information on a machine readable format.
The "status" element specifies this categorization:
- CONCLUSIVE - The signature rights description is a clear and specific list of alternative sets of people. A machine readable specification is offered.
- IN_CONCLUSIVE - The signature rights description is complex, and a machine readable specification has not yet been implemented.
- NOT_SET - The signature rights or power of procuration has not been specified for the company.
The "options" elements is only included in the response when status is CONCLUSIVE. The content is a list of signature rights alternatives, where each alternative contains a list of the specific required people. In a future release, this functionality may be extended to express more complex variants.
Info | ||
---|---|---|
| ||
NOT_SET means the company has not specified the people with signature rights or power of procuration. For signature rights in general, the understanding of this should be that the entire board of the company is required when signing documents. When it comes to power of procuration, NOT_SET means the company has not defined any procura, and the persons with regular signature rights must handle all signatures. |
Test data
Example test organizations have been prepared in the test environment (Current).