API Reference

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.

GET
/v1/company/{orgNr}/score
curl -X 'GET' \
  'https://api.bislab.no/business/no/v1/company/999572542/score?test=true' \
  -H 'accept: text/plain' \
  -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
RESPONSE
{
  "organisasjonsnummer": "999572542",
  "score": 99,
  "scoreKarakter": "AAA",
  "kredittgrense": 23526
}

Authentication

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:

  • To obtain a bearer token, you need to register an account with Bislab and generate an API key.
  • Contact us to get your API key.
  • Keep your API key secure, as it grants access to your Bislab account and API functionality.

2. Include the Bearer Token in Your Requests:

  • In the header of your API requests, include the Authorization field.
  • Set the value of the Authorization field to Bearer {your_token}.
  • Replace {your_token} with the actual bearer token obtained from Bislab.

3. Handling Authentication Errors:

  • If your bearer token is invalid or expired, the API will respond with an appropriate error code, such as 401 Unauthorized.
  • In such cases, you should contact Bislab and we will refresh your bearer token.
  • All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

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.

GET
/v1/company/{orgNr}/score
curl -X 'GET' \
  'https://api.bislab.no/business/no/v1/company/999572542/score' \
  -H 'accept: text/plain' \
  -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
RESPONSE
{
  "organisasjonsnummer": "999572541",
  "score": 13,
  "scoreKarakter": "C",
  "kredittgrense": 0
}

API Health Check

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.

GET
/v1/health-check
curl -X 'GET' \
  'https://api.bislab.no/business/no/v1/health-check' \
  -H 'accept: text/plain' \
  -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
RESPONSE
{
  "status": "ok",
  "id": "d31505f0-1273-4284-a98f-79a913209536"
}

company/score

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.

Parameters
  • orgNr required

    The organizational number of the company for which you would like to retrieve information on. 9 digits.

Response fields
  • organisasjonsnummer string

    The organizational number of the company that was retrieved information on.

  • score integer

    Credit score for the company. Scale 1-100. Where 100 is best.

  • scoreKarakter string

    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.

  • scoreForklaring string

    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

  • kredittgrense integer

    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.

GET
/v1/company/{orgNr}/score
curl -X 'GET' \
  'https://api.bislab.no/business/no/v1/company/999572542/score' \
  -H 'accept: text/plain' \
  -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
RESPONSE
{
  "organisasjonsnummer": "999572542",
  "score": 99,
  "scoreKarakter": "AAA",
  "scoreForklaring": "Meget høy kredittverdighet",
  "kredittgrense": 23526
}

company/score/info

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.

Parameters
  • orgNr required

    The organizational number of the company for which you would like to retrieve information on. 9 digits.

Response fields
  • organisasjonsnummer string

    The organizational number of the company that was retrieved information on.

  • score integer

    Credit score for the company. Scale 1-100. Where 100 is best.

  • scoreKarakter string

    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.

  • scoreForklaring string

    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

  • kredittgrense integer

    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.

  • foretaksnavn string

    Legal company name.

  • organisasjonsform string

    Organizational form/legal structure.

  • status string

    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.

  • statusDato string

    Date from when the latest status became active. For the status "Aktiv" the field is null.

  • antallAnsatte integer

    Number of employees.

  • naeringskode string

    Business activity code description.

  • stiftelsesdato string

    Date of incorporation.

  • forretningsadresseKommune string

    Business address municipality.

  • forretningsadressePostnummer string

    Business address postal code.

  • forretningsadresseAdresse string

    Business street address.

  • dagligLederNavn string

    Name of managing director.

  • regnskapsaar integer

    Fiscal year for latest updated financial reporting figures.

  • driftsinntekter integer

    Operating revenues.

  • driftskostnader integer

    Operating expenses.

  • driftsresultat integer

    Operating income/loss.

  • sumEiendeler integer

    Total assets.

  • sumGjeld integer

    Total liabilities.

  • sumEgenkapital integer

    Total equity.

  • betalingsanmerkningerAntall integer

    Number of unique active payment remarks.

  • betalingsanmerkningerBelop integer

    Sum of the value of active payment remarks.

GET
/v1/company/{orgNr}/score/info
curl -X 'GET' \
  'https://api.bislab.no/business/no/v1/company/999572542/score/info' \
  -H 'accept: text/plain' \
  -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
RESPONSE
{
  "organisasjonsnummer": "999572542",
  "score": 1,
  "scoreKarakter": "C",
  "scoreForklaring": "Meget lav kredittverdighet",
  "kredittgrense": 0,
  "foretaksnavn": "Test AS",
  "organisasjonsform": "AS",
  "status": "Aktiv",
  "statusDato": "null",
  "antallAnsatte": 11,
  "naeringskode": "Detaljhandel med biler og lette motorvogner, unntatt motorsykler",
  "stiftelsesdato": "4/23/2019",
  "forretningsadresseKommune": "Oslo",
  "forretningsadressePostnummer": "0194",
  "forretningsadresseAdresse": "Ole Hansen vei 1",
  "dagligLederNavn": "Ole Hansen",
  "regnskapsaar": 2021,
  "driftsinntekter": 217523,
  "driftskostnader": 280960,
  "driftsresultat": -37691,
  "sumEiendeler": 0,
  "sumGjeld": 11398,
  "sumEgenkapital": -163362,
  "betalingsanmerkningerAntall": 15,
  "betalingsanmerkningerBelop": 2345986
  }

person/score

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.

Parameters
  • id required

    The national identification number for the person which you would like to retrieve information on. 11 digits.

Response fields
  • score integer

    Credit score for the person. Scale 1-100. Where 100 is best.

  • scoreKarakter string

    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.

  • scoreForklaring string

    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.

  • kredittgrense integer

    Suggested maximum credit limit. The credit limit can be adapted to fit your specific risk tolerance.

GET
/v1/person/{id}/score
curl -X 'GET' \
  'https://api.bislab.no/consumer/no/v1/person/12018930812/score' \
  -H 'accept: text/plain' \
  -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
RESPONSE
{
  "score": 87,
  "scoreKarakter": "A",
  "scoreForklaring": "Meget høy kredittverdighet",
  "kredittgrense": 78526
}

person/score/info

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.

Parameters
  • id required

    The national identification number for the person which you would like to retrieve information on. 11 digits.

Response fields
  • foedselsdato string

    Date of birth. dd-mm-yyyy.

  • fornavn string

    First name.

  • etternavn string

    Last name.

  • score integer

    Credit score for the person. Scale 1-100. Where 100 is best.

  • scoreKarakter string

    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.

  • scoreForklaring string

    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.

  • kredittgrense integer

    Suggested maximum credit limit. The credit limit can be adapted to fit your specific risk tolerance.

  • bostedsadresseKommune string

    Name of municipality.

  • bostedsadressePostnummer string

    Zip code.

  • bostedsadresseAdresse string

    Address and house number.

  • ligningsaar integer

    Tax year.

  • nettoInntekt integer

    Net income.

  • nettoFormue integer

    Net worth.

  • skatt integer

    Tax.

  • eierskapMotorvogn boolean

    True if the person either fully or partly owns at least one registered vehicle. Including motorcyles.

  • eierskapHelaarsbolig boolean

    True if the person either fully or partly owns at least one permanent residence.

  • innehaverEnk boolean

    True if the person has at least one business with the legal form sole proprietorship.

  • majoritetseierAs boolean

    True if the person owns at least 50% in one or more Norwegian limited companies.

  • dagligLederAntall integer

    Number of unique active roles as managing director.

  • styrelederAntall integer

    Number of unique active roles as chairman of the board.

  • styremedlemAntall integer

    Number of unique active roles as board member.

  • betalingsanmerkningerBelop integer

    Sum of the value of active payment remarks.

  • betalingsanmerkningerAntall integer

    Number of unique active payment remarks.

GET
/v1/person/{id}/score/info
curl -X 'GET' \
  'https://api.bislab.no/consumer/no/v1/person/12018930812/score/info' \
  -H 'accept: text/plain' \
  -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
RESPONSE
{
  "foedselsdato": "15-01-1949",
  "fornavn": "GEIR BJØRN",
  "etternavn": "UGLETOPPEN",
  "score": 62,
  "scoreKarakter": "B",
  "scoreForklaring": "Høy kredittverdighet",
  "kredittgrense": 50000,
  "bostedsadresseKommune": "Oslo",
  "bostedsadressePostnummer": "0262",
  "bostedsadresseAdresse": "Abels gate 15",
  "ligningsaar": 2022,
  "netttoInntekt": 890351,
  "nettoFormue": 2937456,
  "skatt": 459132,
  "eierskapMotorvogn": true,
  "eierskapHelaarsbolig": false,
  "innehaverEnk": false,
  "majoritetseierAs": true,
  "dagligLederAntall": 1,
  "styrelederAntall": 1,
  "styremedlemAntall": 2,
  "betalingsanmerkningerAntall": 0,
  "betalingsanmerkningerBelop": 0
}

partner/customer/create

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.

    REQUEST FIELDS
    • orgNr string

      Organizational number of the customer for which you would like to create a partnerCustomerId. 9 digits.

    • referenceId Optional

      Your internal reference ID on the customer.

    • companyName string

      Name of the company of the customer.

    • contactEmail string

      Customer contact email address to be used in notification letters.

    • contactPhone string

      Customer contact phone to be used in notification letters.

    • billingEmail string

      Customer billing email address to be used for billing of Bislab services.

    • enabled true

      "true" if the customer should have access.

    • b2bScoreAccess true

      "true" if the customer should have access.

    • b2bScoreInfoAccess true

      "true" if the customer should have access.

    • b2cScoreAccess true

      "true" if the customer should have access.

    • newCompaniesAndEnkAccesss true

      "true" if the customer should have access.

    Response fields
    • partnerCustomerId string

      Id of the customer created. The partnerCustomerId is required when doing requests with the partner API endpoints.

    • status string

      Success or error.

    POST
    /v1/partner/customer/create
    curl -X 'POST' \
      'https://api.bislab.no/business/no/v1/partner/customer/create' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    REQUEST
    {
      "orgNr": "string",
      "referenceId": "string",
      "companyName": "string",
      "contactEmail": "string",
      "contactPhone": "string",
      "billingEmail": "string",
      "enabled": true,
      "b2bScoreAccess": true,
      "b2bScoreInfoAccess": true,
      "b2cScoreAccess": true,
      "newCompaniesAndEnkAccess": true
    }
    
    RESPONSE
    {
      "partnerCustomerId": "string",
      "status": "string"
    }
    

    partner/customer/update

    This endpoint enables you to update the information on each unique partner customer.

    Parameters
    • partnerCustomerId required

      Id of the customer which you would like to update information on.

    ReQUEST fields
    • orgNr string

      Organizational number of the customer. 9 digits.

    • referenceId string

      Reference ID for the customer.

    • companyName string

      Name of the company of the customer.

    • contactEmail string

      Customer contact email address to be used in notification letters.

    • contactPhone string

      Customer contact phone to be used in notification letters.

    • billingEmail string

      Customer billing email address to be used for billing of Bislab services.

    • enabled true

      "true" if the customer should have access.

    • b2bScoreAccess true

      "true" if the customer should have access.

    • b2bScoreInfoAccess true

      "true" if the customer should have access.

    • b2cScoreAccess true

      "true" if the customer should have access.

    • newCompaniesAndEnkAccesss true

      "true" if the customer should have access.

    Response fields
    • partnerCustomerId string

      Id of the customer.

    • orgNr string

      Organizational number of the customer. 9 digits.

    • referenceId string

      Reference ID for the customer.

    • companyName string

      Name of the company of the customer.

    • contactEmail string

      Customer contact email address to be used in notification letters.

    • contactPhone string

      Customer contact phone to be used in notification letters.

    • billingEmail string

      Customer billing email address to be used for billing of Bislab services.

    • enabled true

      "true" if the customer should have access.

    • b2bScoreAccess true

      "true" if the customer should have access.

    • b2bScoreInfoAccess true

      "true" if the customer should have access.

    • b2cScoreAccess true

      "true" if the customer should have access.

    • newCompaniesAndEnkAccesss true

      "true" if the customer should have access.

    PUT
    /v1/partner/customer/{partnerCustomerId}
    curl -X 'PUT' \
      'https://api.bislab.no/business/no/v1/partner/customer/83653527735' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    REQUEST
    {
      "orgNr": "string",
      "referenceId": "string",
      "companyName": "string",
      "contactEmail": "string",
      "contactPhone": "string",
      "billingEmail": "string",
      "enabled": true,
      "b2bScoreAccess": true,
      "b2bScoreInfoAccess": true,
      "b2cScoreAccess": true,
      "newCompaniesAndEnkAccess": true
    }
    
    RESPONSE
    {
      "partnerCustomerId": "string",
      "orgNr": "string",
      "referenceId": "string",
      "companyName": "string",
      "contactEmail": "string",
      "contactPhone": "string",
      "billingEmail": "string",
      "enabled": true,
      "b2bScoreAccess": true,
      "b2bScoreInfoAccess": true,
      "b2cScoreAccess": true,
      "newCompaniesAndEnkAccess": true
    }
    

    partner/customer/get

    This endpoint enables you to retrieve the current information that is stored on each unique partner customer.

    Parameters
    • partnerCustomerId required

      Id of the customer which you would like to retrieve information on.

    Response fields
    • partnerCustomerId string

      Id of the customer.

    • orgNr string

      Organizational number of the customer. 9 digits.

    • referenceId string

      Reference ID for the customer.

    • companyName string

      Name of the company of the customer.

    • contactEmail string

      Customer contact email address to be used in notification letters.

    • contactPhone string

      Customer contact phone to be used in notification letters.

    • billingEmail string

      Customer billing email address to be used for billing of Bislab services.

    • enabled true

      "true" if the customer should have access.

    • b2bScoreAccess true

      "true" if the customer should have access.

    • b2bScoreInfoAccess true

      "true" if the customer should have access.

    • b2cScoreAccess true

      "true" if the customer should have access.

    • newCompaniesAndEnkAccesss true

      "true" if the customer should have access.

    GET
    /v1/partner/customer/{partnerCustomerId}
    curl -X 'GET' \
      'https://api.bislab.no/business/no/v1/partner/customer/83653527735' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    RESPONSE
    {
      "partnerCustomerId": "string",
      "orgNr": "string",
      "referenceId": "string",
      "companyName": "string",
      "contactEmail": "string",
      "contactPhone": "string",
      "billingEmail": "string",
      "enabled": true,
      "b2bScoreAccess": true,
      "b2bScoreInfoAccess": true,
      "b2cScoreAccess": true,
      "newCompaniesAndEnkAccess": true
    }
    

    partner/customer/reference/get

    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.

    Parameters
    • referenceId required

      Your internal reference ID of the customer which you would like to retrieve information on.

    Response fields
    • partnerCustomerId string

      Id of the customer.

    • orgNr string

      Organizational number of the customer. 9 digits.

    • referenceId string

      Reference ID for the customer.

    • companyName string

      Name of the company of the customer.

    • contactEmail string

      Customer contact email address to be used in notification letters.

    • contactPhone string

      Customer contact phone to be used in notification letters.

    • billingEmail string

      Customer billing email address to be used for billing of Bislab services.

    • enabled true

      "true" if the customer should have access.

    • b2bScoreAccess true

      "true" if the customer should have access.

    • b2bScoreInfoAccess true

      "true" if the customer should have access.

    • b2cScoreAccess true

      "true" if the customer should have access.

    • newCompaniesAndEnkAccesss true

      "true" if the customer should have access.

    GET
    /v1/partner/customer/reference/{referenceId}
    curl -X 'GET' \
      'https://api.bislab.no/business/no/v1/partner/customer/reference/836535' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    RESPONSE
    {
      "partnerCustomerId": "string",
      "orgNr": "string",
      "referenceId": "string",
      "companyName": "string",
      "contactEmail": "string",
      "contactPhone": "string",
      "billingEmail": "string",
      "enabled": true,
      "b2bScoreAccess": true,
      "b2bScoreInfoAccess": true,
      "b2cScoreAccess": true,
      "newCompaniesAndEnkAccess": true
    }
    

    partner/customer/activated

    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.

    Parameters
    • No parameters.

    Response fields
    • orgNr string

      Organizational number of the customer. 9 digits.

    • b2bScoreAccess true

      "true" if the customer should have access.

    • b2bScoreInfoAccess true

      "true" if the customer should have access.

    • b2cScoreAccess true

      "true" if the customer should have access.

    • newCompaniesAndEnkAccesss true

      "true" if the customer should have access.

    GET
    /v1/partner/customer/activated
    curl -X 'GET' \
      'https://api.bislab.no/business/no/v1/partner/customer/activated' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    RESPONSE
    [
      {
        "orgNr": "string",
        "b2bScoreAccess": true,
        "b2bScoreInfoAccess": true,
        "b2cScoreAccess": true,
        "newCompaniesAndEnkAccess": true
      }
    ]
    

    partner/customer/activated/orgNr

    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.

    Parameters
    • orgNr required

      The organizational number (9 digits) of the company for which you would like to check access privileges for.

    Response fields
    • orgNr string

      Organizational number of the customer. 9 digits.

    • b2bScoreAccess true

      "true" if the customer should have access.

    • b2bScoreInfoAccess true

      "true" if the customer should have access.

    • b2cScoreAccess true

      "true" if the customer should have access.

    • newCompaniesAndEnkAccesss true

      "true" if the customer should have access.

    GET
    /v1/partner/customer/activated/{orgNr}
    curl -X 'GET' \
      'https://api.bislab.no/business/no/v1/partner/customer/activated/836535549' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    RESPONSE
    {
      "orgNr": "string",
      "b2bScoreAccess": true,
      "b2bScoreInfoAccess": true,
      "b2cScoreAccess": true,
      "newCompaniesAndEnkAccess": true
    }
    

    partner/company/score

    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.

    Parameters
    • orgNr required

      The organizational number of the company for which you would like to retrieve information on. 9 digits.

    • partnerCustomerId required

      The unique identification number of the partner customer that is doing the request.

    Response fields
    • organisasjonsnummer string

      The organizational number of the company that was retrieved information on.

    • score integer

      Credit score for the company. Scale 1-100. Where 100 is best.

    • scoreKarakter string

      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.

    • scoreForklaring string

      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

    • kredittgrense integer

      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.

    GET
    /v1/company/partner/{partnerCustomerId}/{orgNr}/score
    curl -X 'GET' \
      'https://api.bislab.no/business/no/v1/company/partner/8262863428/999572542/score' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    RESPONSE
    {
      "organisasjonsnummer": "999572542",
      "score": 99,
      "scoreKarakter": "AAA",
      "scoreForklaring": "Meget høy kredittverdighet",
      "kredittgrense": 23526
    }
    

    partner/company/score/info

    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.

    Parameters
    • orgNr required

      The organizational number of the company for which you would like to retrieve information on.

    • partnerCustomerId required

      The unique identification number of the partner customer that is doing the request.

    Response fields
    • organisasjonsnummer string

      The organizational number of the company that was retrieved information on. 9 digits.

    • score integer

      Credit score for the company. Scale 1-100. Where 100 is best.

    • scoreKarakter string

      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.

    • scoreForklaring string

      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

    • kredittgrense integer

      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.

    • foretaksnavn string

      Legal company name.

    • organisasjonsform string

      Organizational form/legal structure.

    • status string

      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.

    • statusDato string

      Date from when the latest status became active. For the status "Aktiv" the field is null.

    • antallAnsatte integer

      Number of employees.

    • naeringskode string

      Business activity code description.

    • stiftelsesdato string

      Date of incorporation.

    • forretningsadresseKommune string

      Business address municipality.

    • forretningsadressePostnummer string

      Business address postal code.

    • forretningsadresseAdresse string

      Business street address.

    • dagligLederNavn string

      Name of managing director.

    • regnskapsaar integer

      Fiscal year for latest updated financial reporting figures.

    • driftsinntekter integer

      Operating revenues.

    • driftskostnader integer

      Operating expenses.

    • driftsresultat integer

      Operating income/loss.

    • sumEiendeler integer

      Total assets.

    • sumGjeld integer

      Total liabilities.

    • sumEgenkapital integer

      Total equity.

    • betalingsanmerkningerAntall integer

      Number of unique active payment remarks.

    • betalingsanmerkningerBelop integer

      Sum of the value of active payment remarks.

    GET
    ..partner/{partnerCustomerId}/{orgNr}/score/info
    curl -X 'GET' \
      'https://api.bislab.no/business/no/v1/company/partner/8262863428/999572542/score/info' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    RESPONSE
    {
      "organisasjonsnummer": "999572542",
      "score": 1,
      "scoreKarakter": "C",
      "scoreForklaring": "Meget lav kredittverdighet",
      "kredittgrense": 0,
      "foretaksnavn": "Test AS",
      "organisasjonsform": "AS",
      "status": "Aktiv",
      "statusDato": "null",
      "antallAnsatte": 11,
      "naeringskode": "Detaljhandel med biler og lette motorvogner, unntatt motorsykler",
      "stiftelsesdato": "4/23/2019",
      "forretningsadresseKommune": "Oslo",
      "forretningsadressePostnummer": "0194",
      "forretningsadresseAdresse": "Ole Hansen vei 1",
      "dagligLederNavn": "Ole Hansen",
      "regnskapsaar": 2021,
      "driftsinntekter": 217523,
      "driftskostnader": 280960,
      "driftsresultat": -37691,
      "sumEiendeler": 0,
      "sumGjeld": 11398,
      "sumEgenkapital": -163362,
      "betalingsanmerkningerAntall": 15,
      "betalingsanmerkningerBelop": 2345986
      }
    

    partner/person/score

    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.

    Parameters
    • id required

      The national identification number for the person which you would like to retrieve information on. 11 digits.

    • partnerCustomerId required

      The unique identification number of the partner customer that is doing the request.

    Response fields
    • score integer

      Credit score for the person. Scale 1-100. Where 100 is best.

    • scoreKarakter string

      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.

    • scoreForklaring string

      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.

    • kredittgrense integer

      Suggested maximum credit limit. The credit limit can be adapted to fit your specific risk tolerance.

    GET
    /v1/person/partner/{partnerCustomerId}/score/{id}
    curl -X 'GET' \
      'https://api.bislab.no/consumer/no/v1/person/partner/8262863428/score/09065420182' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    RESPONSE
    {
      "score": 87,
      "scoreKarakter": "A",
      "scoreForklaring": "Meget høy kredittverdighet",
      "kredittgrense": 78526
    }
    

    usage

    The usage endpoint allows you to get the number of billable API requests per product for a specified time period.

    Parameters
    • from Optional

      Start of the period you would like to retrieve usage information for. String (date-time).

    • to Optional

      End of the period you would like to retrieve usage information for. String (date-time).

    Response fields
    • companyScoreRequests integer

      Number of billable requests to the company/score endpoint.

    • companyScoreInfoRequests integer

      Number of billable requests to the company/score/info endpoint.

    • personScoreRequests integer

      Number of billable requests to the person/score endpoint.

    • personScoreInfoRequests integer

      Number of billable requests to the person/sore/info endpoint.

    GET
    /v1/report/usage
    curl -X 'GET' \
      'https://api.bislab.no/business/no/v1/report/usage' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    RESPONSE
    {
      "companyScoreRequests": 0,
      "companyScoreInfoRequests": 0,
      "personScoreRequests": 0,
      "personScoreInfoRequests": 0
    }
    

    partner/usage

    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.

    Parameters
    • from Optional

      Start of the period you would like to retrieve usage information for. String (date-time).

    • to Optional

      End of the period you would like to retrieve usage information for. String (date-time).

    Response fields
    • partnerCustomerId string

      The unique identification number of each partner customer that you are retrieving usage on.

    • companyScoreRequests integer

      Number of billable requests to the company/score endpoint.

    • companyScoreInfoRequests integer

      Number of billable requests to the company/score/info endpoint.

    • personScoreRequests integer

      Number of billable requests to the person/score endpoint.

    • personScoreInfoRequests integer

      Number of billable requests to the person/sore/info endpoint.

    GET
    /v1/report/partner/usage
    curl -X 'GET' \
      'https://api.bislab.no/business/no/v1/report/partner/usage' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    RESPONSE
    [
      {
        "partnerCustomerId": "string",
        "companyScoreRequests": 0,
        "companyScoreInfoRequests": 0,
        "personScoreRequests": 0,
        "personScoreInfoRequests": 0
      }
    ]
    

    partner/customer/usage

    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.

    Parameters
    • from Optional

      Start of the period you would like to retrieve usage information for. String (date-time).

    • to Optional

      End of the period you would like to retrieve usage information for. String (date-time).

    • partnerCustomerId required

      The unique identification number of the partner customer that is doing the request.

    Response fields
    • partnerCustomerId string

      The unique identification number of the partner customer that you are retrieving usage on.

    • companyScoreRequests integer

      Number of billable requests to the company/score endpoint.

    • companyScoreInfoRequests integer

      Number of billable requests to the company/score/info endpoint.

    • personScoreRequests integer

      Number of billable requests to the person/score endpoint.

    • personScoreInfoRequests integer

      Number of billable requests to the person/sore/info endpoint.

    GET
    /v1/report/partner/{partnerCustomerId}/usage
    curl -X 'GET' \
      'https://api.bislab.no/business/no/v1/report/partner/8262863428/usage' \
      -H 'accept: text/plain' \
      -H 'Authorization: Bearer a9aeyh6-c98we26d-54-o945-836gb76jgl'
    RESPONSE
    {
      "partnerCustomerId": "string",
      "companyScoreRequests": 0,
      "companyScoreInfoRequests": 0,
      "personScoreRequests": 0,
      "personScoreInfoRequests": 0
    }