The Bislab API is organized around REST. Our API has predictable resource-oriented URLs, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.
Base URL requests on companies: https://api.bislab.no/business/no
Base URL requests on consumers: https://api.bislab.no/consumer/no
You can test the Bislab API using your live bearer token by adding ?test=true to the request URL. Test requests will not incur any charges. Contact us to initiate the setup process and obtain your authentication token.
Bislab also create custom endpoints not listed in this documentation, typically for customers with complex requirements in bank, finance, law firms and collection agencies.
For convenient exploration of the Bislab API, we offer a swagger interface for request on companies and another for requests on consumers. This user-friendly tool allows you to interactively browse and experiment with the available endpoints and their functionalities.
To access the Bislab API endpoints, you need to authenticate your requests using a bearer token. The bearer token serves as your key to authorize and validate your API calls. Follow the steps below to include the bearer token in your requests:
1. Obtain a bearer token:
2. Include the Bearer Token in Your Requests:
3. Handling Authentication Errors:
Note: Keep your bearer token confidential and avoid sharing it with unauthorized parties. Treat it as sensitive information to maintain the security of your Bislab account and API access.
The health check endpoint allows you to retrieve information about the status and health of the API service. This endpoint provides a simple and convenient way to monitor the availability and performance of the API.
Upon a successful request to the health check endpoint, you will receive a response containing the health status of the API service. "status": "ok" indicates that the API service is working as expected.
Note: In case the API service encounters any issues or is undergoing maintenance, the health check response may provide additional details or return a different status code to reflect the current situation accurately.
Please make use of the health check endpoint to monitor the availability and status of the API service. It can be utilized for automated monitoring systems or to ensure that the API is functioning correctly before making other requests.
The score endpoint allows you to retrieve the credit rating of a company based on its unique organization number. The credit rating is returned both as a single value and a rating, indicating the company's creditworthiness.
Error Handling: If an error occurs, such as an invalid organization number or server issues, an appropriate error response will be returned along with the corresponding status code.
The organizational number of the company for which you would like to retrieve information on. 9 digits.
The organizational number of the company that was retrieved information on.
Credit score for the company. Scale 1-100. Where 100 is best.
The credit rating indicates the creditworthiness of the company, using a scale ranging from AAA, AA, A, B, to C, with AAA being the highest rating. A rating of D signifies that the company is either bankrupt or deemed not creditworthy under any circumstances. The code IR indicates insufficient available information to calculate a credit rating, while AN signifies that the company is newly established, and financial information is not yet available.
The credit rating explanation is a short summary of the credit rating and returns the following values for different credit ratings:
AAA = Meget høy kredittverdighet
AA = Høy kredittverdighet
A = Kredittverdig
B = Lav kredittverdighet
C = Meget lav kredittverdighet
D = Ikke kredittverdig
IR = Ingen score
AN = Nyoppstartet
Suggested maximum credit limit. The credit limit can be adapted to fit your specific risk tolerance. Only companies with a credit rating of A or better will get a credit limit.
The score/info endpoint allows you to retrieve credit rating, basic company information and top level financial information of a company based on its unique organization number. The credit rating is returned both as a single value and a rating, indicating the company's creditworthiness.
Error Handling: If an error occurs, such as an invalid organization number or server issues, an appropriate error response will be returned along with the corresponding status code.
The organizational number of the company for which you would like to retrieve information on. 9 digits.
The organizational number of the company that was retrieved information on.
Credit score for the company. Scale 1-100. Where 100 is best.
The credit rating indicates the creditworthiness of the company, using a scale ranging from AAA, AA, A, B, to C, with AAA being the highest rating. A rating of D signifies that the company is either bankrupt or deemed not creditworthy under any circumstances. The code IR indicates insufficient available information to calculate a credit rating, while AN signifies that the company is newly established, and financial information is not yet available.
The credit rating explanation is a short summary of the credit rating and returns the following values for different credit ratings:
AAA = Meget høy kredittverdighet
AA = Høy kredittverdighet
A = Kredittverdig
B = Lav kredittverdighet
C = Meget lav kredittverdighet
D = Ikke kredittverdig
IR = Ingen score
AN = Nyoppstartet
Suggested maximum credit limit. The credit limit can be adapted to fit your specific risk tolerance. Only companies with a credit rating of A or better will get a credit limit.
Legal company name.
Organizational form/legal structure.
Status on the company. "Aktiv" if the company is registered as active. "Under avvikling" when the company is under liquidation. "Konkurs" if the company is "bankrupt". "Tvangsavviklet" or "Tvangsoppløst" when the company is compulsorily dissolved.
Date from when the latest status became active. For the status "Aktiv" the field is null.
Number of employees.
Business activity code description.
Date of incorporation.
Business address municipality.
Business address postal code.
Business street address.
Name of managing director.
Fiscal year for latest updated financial reporting figures.
Operating revenues.
Operating expenses.
Operating income/loss.
Total assets.
Total liabilities.
Total equity.
Number of unique active payment remarks.
Sum of the value of active payment remarks.
The score endpoint allows you to retrieve the credit rating of a person based on the persons unique national identification number (11 digits). The credit rating is returned both as a single value and a rating, indicating the person's creditworthiness.
Error Handling: If an error occurs, such as an invalid identification number or server issues, an appropriate error response will be returned along with the corresponding status code.
The national identification number for the person which you would like to retrieve information on. 11 digits.
Credit score for the person. Scale 1-100. Where 100 is best.
The credit rating indicates the creditworthiness of the person, using a scale ranging from A, B, C, D, to E, with A being the highest rating. A rating of E signifies that the person has a very low creditworthiness. The code IR signifies that the person is not creditworthy because of one or more of the following: Not a permanent citizen of Norway, person under guardianship, forced proceedings, no assets for enforcement and more. KS means that the person has activated credit freeze that must be deactivated before a credit rating will be returned.
The credit rating explanation is a short summary of the credit rating and returns the following values for different credit ratings:
A = Meget høy kredittverdighet
B = Høy kredittverdighet
C = Kredittverdig
D = Lav kredittverdighet
E = Meget lav kredittverdighet
IR = Ingen score
KS = Kredittsperre finnes. Må oppheves før data kan utleveres.
Suggested maximum credit limit. The credit limit can be adapted to fit your specific risk tolerance.
The score endpoint allows you to retrieve the credit rating of a person based on the persons unique national identification number (11 digits). The credit rating is returned both as a single value and a rating, indicating the person's creditworthiness.
Error Handling: If an error occurs, such as an invalid identification number or server issues, an appropriate error response will be returned along with the corresponding status code.
The national identification number for the person which you would like to retrieve information on. 11 digits.
Date of birth. dd-mm-yyyy.
First name.
Last name.
Credit score for the person. Scale 1-100. Where 100 is best.
The credit rating indicates the creditworthiness of the person, using a scale ranging from A, B, C, D, to E, with A being the highest rating. A rating of E signifies that the person has a very low creditworthiness. The code IR signifies that the person is not creditworthy because of one or more of the following: Not a permanent citizen of Norway, person under guardianship, forced proceedings, no assets for enforcement and more. KS means that the person has activated credit freeze that must be deactivated before a credit rating will be returned.
The credit rating explanation is a short summary of the credit rating and returns the following values for different credit ratings:
A = Meget høy kredittverdighet
B = Høy kredittverdighet
C = Kredittverdig
D = Lav kredittverdighet
E = Meget lav kredittverdighet
IR = Ingen score
KS = Kredittsperre finnes. Må oppheves før data kan utleveres.
Suggested maximum credit limit. The credit limit can be adapted to fit your specific risk tolerance.
Name of municipality.
Zip code.
Address and house number.
Tax year.
Net income.
Net worth.
Tax.
True if the person either fully or partly owns at least one registered vehicle. Including motorcyles.
True if the person either fully or partly owns at least one permanent residence.
True if the person has at least one business with the legal form sole proprietorship.
True if the person owns at least 50% in one or more Norwegian limited companies.
Number of unique active roles as managing director.
Number of unique active roles as chairman of the board.
Number of unique active roles as board member.
Number of unique active payment remarks.
Sum of the value of active payment remarks.
The create endpoint is used to create a new partner customer and retrieve the unique partnerCustomerId that must be submitted when doing requests in the partner endpoints.
Organizational number of the customer for which you would like to create a partnerCustomerId. 9 digits.
Your internal reference ID on the customer.
Name of the company of the customer.
Customer contact email address to be used in notification letters.
Customer contact phone to be used in notification letters.
Customer billing email address to be used for billing of Bislab services.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
Id of the customer created. The partnerCustomerId is required when doing requests with the partner API endpoints.
Success or error.
This endpoint enables you to update the information on each unique partner customer.
Id of the customer which you would like to update information on.
Organizational number of the customer. 9 digits.
Reference ID for the customer.
Name of the company of the customer.
Customer contact email address to be used in notification letters.
Customer contact phone to be used in notification letters.
Customer billing email address to be used for billing of Bislab services.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
Id of the customer.
Organizational number of the customer. 9 digits.
Reference ID for the customer.
Name of the company of the customer.
Customer contact email address to be used in notification letters.
Customer contact phone to be used in notification letters.
Customer billing email address to be used for billing of Bislab services.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
This endpoint enables you to retrieve the current information that is stored on each unique partner customer.
Id of the customer which you would like to retrieve information on.
Id of the customer.
Organizational number of the customer. 9 digits.
Reference ID for the customer.
Name of the company of the customer.
Customer contact email address to be used in notification letters.
Customer contact phone to be used in notification letters.
Customer billing email address to be used for billing of Bislab services.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
This endpoint enables you to retrieve the current information that is stored on each unique partner customer using your internal referenceId that can be generating when creating a new partner customer.
Your internal reference ID of the customer which you would like to retrieve information on.
Id of the customer.
Organizational number of the customer. 9 digits.
Reference ID for the customer.
Name of the company of the customer.
Customer contact email address to be used in notification letters.
Customer contact phone to be used in notification letters.
Customer billing email address to be used for billing of Bislab services.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
This endpoint enables you to retrieve information about the product access privileges for all applicable companies. Companies will be available here when they have successfully been evaluated and granted access. The information about access privileges retrieved on a company in this endpoints should be used when creating a new customer in the partner/customer/create endpoint.
No parameters.
Organizational number of the customer. 9 digits.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
This endpoint enables you to retrieve information about the product access privileges for a specific company. Companies will be available here when they have successfully been evaluated and granted access. The information about access privileges retrieved on a company in this endpoints should be used when creating a new customer in the partner/customer/create endpoint.
The organizational number (9 digits) of the company for which you would like to check access privileges for.
Organizational number of the customer. 9 digits.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
"true" if the customer should have access.
The score endpoint allows you to retrieve the credit rating of a company based on its unique organization number. The credit rating is returned both as a single value and a rating, indicating the company's creditworthiness.
Error Handling: If an error occurs, such as an invalid organization number or server issues, an appropriate error response will be returned along with the corresponding status code.
The organizational number of the company for which you would like to retrieve information on. 9 digits.
The unique identification number of the partner customer that is doing the request.
The organizational number of the company that was retrieved information on.
Credit score for the company. Scale 1-100. Where 100 is best.
The credit rating indicates the creditworthiness of the company, using a scale ranging from AAA, AA, A, B, to C, with AAA being the highest rating. A rating of D signifies that the company is either bankrupt or deemed not creditworthy under any circumstances. The code IR indicates insufficient available information to calculate a credit rating, while AN signifies that the company is newly established, and financial information is not yet available.
The credit rating explanation is a short summary of the credit rating and returns the following values for different credit ratings:
AAA = Meget høy kredittverdighet
AA = Høy kredittverdighet
A = Kredittverdig
B = Lav kredittverdighet
C = Meget lav kredittverdighet
D = Ikke kredittverdig
IR = Ingen score
AN = Nyoppstartet
Suggested maximum credit limit. The credit limit can be adapted to fit your specific risk tolerance. Only companies with a credit rating of A or better will get a credit limit.
The score/info endpoint allows you to retrieve credit rating, basic company information and top level financial information of a company based on its unique organization number. The credit rating is returned both as a single value and a rating, indicating the company's creditworthiness.
Error Handling: If an error occurs, such as an invalid organization number or server issues, an appropriate error response will be returned along with the corresponding status code.
The organizational number of the company for which you would like to retrieve information on.
The unique identification number of the partner customer that is doing the request.
The organizational number of the company that was retrieved information on. 9 digits.
Credit score for the company. Scale 1-100. Where 100 is best.
The credit rating indicates the creditworthiness of the company, using a scale ranging from AAA, AA, A, B, to C, with AAA being the highest rating. A rating of D signifies that the company is either bankrupt or deemed not creditworthy under any circumstances. The code IR indicates insufficient available information to calculate a credit rating, while AN signifies that the company is newly established, and financial information is not yet available.
The credit rating explanation is a short summary of the credit rating and returns the following values for different credit ratings:
AAA = Meget høy kredittverdighet
AA = Høy kredittverdighet
A = Kredittverdig
B = Lav kredittverdighet
C = Meget lav kredittverdighet
D = Ikke kredittverdig
IR = Ingen score
AN = Nyoppstartet
Suggested maximum credit limit. The credit limit can be adapted to fit your specific risk tolerance. Only companies with a credit rating of A or better will get a credit limit.
Legal company name.
Organizational form/legal structure.
Status on the company. "Aktiv" if the company is registered as active. "Under avvikling" when the company is under liquidation. "Konkurs" if the company is "bankrupt". "Tvangsavviklet" or "Tvangsoppløst" when the company is compulsorily dissolved.
Date from when the latest status became active. For the status "Aktiv" the field is null.
Number of employees.
Business activity code description.
Date of incorporation.
Business address municipality.
Business address postal code.
Business street address.
Name of managing director.
Fiscal year for latest updated financial reporting figures.
Operating revenues.
Operating expenses.
Operating income/loss.
Total assets.
Total liabilities.
Total equity.
Number of unique active payment remarks.
Sum of the value of active payment remarks.
The score endpoint allows you to retrieve the credit rating of a person based on the persons unique national identification number (11 digits). The credit rating is returned both as a single value and a rating, indicating the person's creditworthiness.
Error Handling: If an error occurs, such as an invalid identification number or server issues, an appropriate error response will be returned along with the corresponding status code.
The national identification number for the person which you would like to retrieve information on. 11 digits.
The unique identification number of the partner customer that is doing the request.
Credit score for the person. Scale 1-100. Where 100 is best.
The credit rating indicates the creditworthiness of the person, using a scale ranging from A, B, C, D, to E, with A being the highest rating. A rating of E signifies that the person has a very low creditworthiness. The code IR signifies that the person is not creditworthy because of one or more of the following: Not a permanent citizen of Norway, person under guardianship, forced proceedings, no assets for enforcement and more. KS means that the person has activated credit freeze that must be deactivated before a credit rating will be returned.
The credit rating explanation is a short summary of the credit rating and returns the following values for different credit ratings:
A = Meget høy kredittverdighet
B = Høy kredittverdighet
C = Kredittverdig
D = Lav kredittverdighet
E = Meget lav kredittverdighet
IR = Ingen score
KS = Kredittsperre finnes. Må oppheves før data kan utleveres.
Suggested maximum credit limit. The credit limit can be adapted to fit your specific risk tolerance.
The score endpoint allows you to retrieve the credit rating of a person based on the persons unique national identification number (11 digits). The credit rating is returned both as a single value and a rating, indicating the person's creditworthiness.
Error Handling: If an error occurs, such as an invalid identification number or server issues, an appropriate error response will be returned along with the corresponding status code.
The national identification number for the person which you would like to retrieve information on. 11 digits.
The unique identification number of the partner customer that is doing the request.
Date of birth. dd-mm-yyyy.
First name.
Last name.
Credit score for the person. Scale 1-100. Where 100 is best.
The credit rating indicates the creditworthiness of the person, using a scale ranging from A, B, C, D, to E, with A being the highest rating. A rating of E signifies that the person has a very low creditworthiness. The code IR signifies that the person is not creditworthy because of one or more of the following: Not a permanent citizen of Norway, person under guardianship, forced proceedings, no assets for enforcement and more. KS means that the person has activated credit freeze that must be deactivated before a credit rating will be returned.
The credit rating explanation is a short summary of the credit rating and returns the following values for different credit ratings:
A = Meget høy kredittverdighet
B = Høy kredittverdighet
C = Kredittverdig
D = Lav kredittverdighet
E = Meget lav kredittverdighet
IR = Ingen score
KS = Kredittsperre finnes. Må oppheves før data kan utleveres.
Suggested maximum credit limit. The credit limit can be adapted to fit your specific risk tolerance.
Name of municipality.
Zip code.
Address and house number.
Tax year.
Net income.
Net worth.
Tax.
True if the person either fully or partly owns at least one registered vehicle. Including motorcyles.
True if the person either fully or partly owns at least one permanent residence.
True if the person has at least one business with the legal form sole proprietorship.
True if the person owns at least 50% in one or more Norwegian limited companies.
Number of unique active roles as managing director.
Number of unique active roles as chairman of the board.
Number of unique active roles as board member.
Number of unique active payment remarks.
Sum of the value of active payment remarks.
The usage endpoint allows you to get the number of billable API requests per product for a specified time period.
Start of the period you would like to retrieve usage information for. String (date-time).
End of the period you would like to retrieve usage information for. String (date-time).
Number of billable requests to the company/score endpoint.
Number of billable requests to the company/score/info endpoint.
Number of billable requests to the person/score endpoint.
Number of billable requests to the person/sore/info endpoint.
The partner usage endpoint allows you to get the number of billable API requests per product for a specified time period for all partner customers.
Start of the period you would like to retrieve usage information for. String (date-time).
End of the period you would like to retrieve usage information for. String (date-time).
The unique identification number of each partner customer that you are retrieving usage on.
Number of billable requests to the company/score endpoint.
Number of billable requests to the company/score/info endpoint.
Number of billable requests to the person/score endpoint.
Number of billable requests to the person/sore/info endpoint.
The partner customer usage endpoint allows you to get the number of billable API requests per product for a specified time period for a specific partner customer.
Start of the period you would like to retrieve usage information for. String (date-time).
End of the period you would like to retrieve usage information for. String (date-time).
The unique identification number of the partner customer that is doing the request.
The unique identification number of the partner customer that you are retrieving usage on.
Number of billable requests to the company/score endpoint.
Number of billable requests to the company/score/info endpoint.
Number of billable requests to the person/score endpoint.
Number of billable requests to the person/sore/info endpoint.