goscore API for developers logo

Getting Started Edit

Last updated: 11.02.2022

Welcome to goscore API! Here you’ll find up-to-date information for integrating with our data collection solution. If you have any questions, please don’t hesitate to drop us a line.

Our API is WIP and available in sandbox mode as well, so you need to contact us to get your API credentials. We’re working hard on making Quick start guide, which walks through your entire gotrack integration step-by-step.

This is what you’ll get if everything went great.

Here’s some useful information.

Something may not happen if you try and do this.

Something bad will happen if you do this.

API keys and access Edit

To gain access to the goscore API, please reach out to us directly. Once you’ve completed the sign up process with us and acknowledged our terms, we’ll provide you client_id and secret_key to start using the APIs.

We’d love to have a kick-off call before the Production launch.

API hosts Edit

We have a Sandbox environment for you to play with and setup integration with your service. When you’re ready, just change the endpoint to the Production.

Current version: 1.0

Name Endpoint
Sandbox https://app.goscore.me/api/[version]
Production https://link.goscore.me/api/[version]

Don’t forget to reach out to us to get your Production credentials

Collect Data with gotrack Edit

API customers can get access to the goscore API by using the gotrack web-app, which uses industry standard OAuth2 authentication methods for transparent and secure access to user data.

This is how gotrack works:

  1. User is taken to https://theia.goscore.me
  2. User select the authentication method, e.g. BankID
  3. An user identificator (ID) (used to retrieve data) is sent back to the application
  4. With the ID together with API access_token, your application can fetch the user’s data from the goscore API.

There is a limited information available. Currently, only unsecured loans are available with this flow. More data controllers are coming.

  1. gotrack generates a special authorization URL to the ID-Porten autthorization
  2. User select a preferable authentication method, e.g. BankID, MinID
  3. After the authorization, user is led to requested data controllers and give a consent using their flow
  4. An user identification (ID) (used to retrieve data) is sent back to the application
  5. With the ID together with API access_token, your application can fetch the user’s data from the goscore API.

Initialization parameters

You need an authorization link to be able to send users to gotrack and this link can be customized with different parameters.

Parameter Description Required?
client_id you unique client ID Yes
scope collected data following the user consent, comma-separated. E.g. unsecured_loans,student_loan,e_invoices. All allowed options: vehicles, unsecured_loans, info, income, student_loan, e_invoices, unsecured_loans_presentation, unsecured_loans_processing, tax_data_pdf Yes
locale language selection. Available languages: en, nb No
iframe on-page integration No
callback_uri redirect URL. This is the path that will receive the code. No
test indicate if test flow is enabled (static data) No
styles_uri URL for your custom CSS file. It overwrites standard styles. Doesn’t apply to an alternative flow No
tax_entities For the tax_data_pdf scope only. Set comma-separated organizational numbers to collect data from correspondent mailbox No

Response

When the gotrack process is done, you will get a response with the result. This will either be a success, error or a status (status available in iframe mode only) and will be delivered to the specified callback_uri. Based on your integration of gotrack, the response will be delivered using on of the following means:

  • Redirect integration - the response will be sent using query parameters to the specified callback_uri.
  • Iframe integration - the response will be sent to the parent window using a postMessage notification.

Redirect mode Edit

In this case the user of your application is redirected to your gotrack URL. Once the gotrack flow is completed, the user will be redirected to your specified callback_uri, e.g. https://my-doamin/oauth/callback

https://my-doamin/oauth/callback?code=123
https://my-doamin/oauth/callback?error=cancelled%20by%20user

iFrame mode Edit

If you integrate gotrack directly in your application via an iframe (this mode is available for verified developers only), the result will be delivered as stringified object via postMessage to the parent window.

{
    "type": "code",
    "code": "6915ab99857fec1e6f2f6c078",
}
{
    "type": "error",
    "error": {
      "status": "BAD_REQUEST",
      "message": "Cancelled by user"
    },
}

Error statuses Edit

Status Description
BAD_REQUEST The gotrack URL was incorrectly configured.
USER_CANCELLED The end user cancelled the flow.
INTERNAL_ERROR An internal error within the goscore service. Please contact support for help.
TEMPORARY_ERROR A temporary error with the 3rd party services. Please try again.

All errors will return JSON in the following format (example below):

{
  "type": "error",
  "error": {
    "status": "BAD_REQUEST",
    "message": "The gotrack URL was incorrectly configured."
  }
}

Versions Edit

As we build technology to support the future of financial services more new features to be implemented in the upcoming versions. Please, check for updates here regarding the maintenance periods.

Version Status Date introduced Available until
1.0 Available Dec 11th, 2020 TBD

CHANGELOG Edit

All notable changes to this APIs are documented here.

[1.0] - 11.02.2022

Added

  • New API to retrieve a complete/combined dataset of the user’s data: /loan_applications API
  • New data collection scope: tax_data_pdf. Data is available within the combined API, so this scope doesn’t come with a dedicated API endpoint.

[1.0] - 15.12.2021

Added

  • New scope is added for direct integration with Norsk Gjeldsinformasjon: unsecured_loans_presentation, unsecured_loans_processing

Authentication Edit

/auth

Headers
Client-ID
client_id you've got from us
Secret-Key
secret_key you've got from us

You need to be authenticated to make API calls. Please, reach out to us to get credentials to try APIs.

You can generate a token using this request. When you get the token, access the relevant data with the consent code/ID saved you got after the gotrack process successfully completed.

Please, keep in mind that token is valid for a limited time

Nothing will work unless you generate an API token

$.ajax({
  url: 'https://link.goscore.me/api/1.0/auth',
  headers: {
      'Client-ID': '<client_id>',
      'Secret-Key': '<secret_key>',
      'Content-Type': 'application/json'
  },
  method: 'POST',
  dataType: 'json',
  success: function(data){
    console.log('success: ' + data);
  }
});
curl -X POST -i -H "Content-Type: application/json" -H "Client-ID: <client_id>" -H "Secret-Key: <secret_key>" https://link.goscore.me/api/1.0/auth
{
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJhcHBfaWQiOjEsImV4cGlyZV9hdCI6MTYxMTA5NzA5NX0.v8Ayvhh-0zarI5eFj6uOvdyO40b7wQZP-uaO7S3ICb8",
  "expire_at": "01-19-2021 22:58"
}

Statuses Edit

Depending on your application settings the data collection process might have various statuses to identify the data quality and potential errors.

Check data collection statuses to get notification when the data is ready. Statuses are available with any information-related API call.

If you’ve activated async data collection, please, check a status using any of the API, e.g. Loan or Personal.

Please, note, that the process take some time and don’t pull the information more than once in a second.

Statuses

Status Description
new Data collection request is created but the process hasn’t been started
in_progress Data collection is in progress
done Full data is collected and available for use
partially_done Data is partially collected and available for retrieval
error Data wasn’t collected because of an error

Please, note, that done, partially_done, and error are final statuses and wouldn’t be updated at any time.

/loan_applications/:id Edit

Get a complete/combined loan application information.

Only returns an information that’s available with the actual api app scope.

Collect a complete loan application dataset in the same format as a separated API responses below. Check the APIs below for a detailed descriptions of the data models.

Scope: any

$.ajax({
  url: 'https://link.goscore.me/api/1.0/loan_applications/1',
  headers: {
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  method: 'GET',
  dataType: 'json',
  success: function(data){
    console.log('success: ' + data);
  }
});
r = requests.get("https://link.goscore.me/api/1.0/loan_applications/1", headers={ "Authorization": "Bearer <token>", "Content-Type": "application/json" })
print r.text
var request = require("request");

function callback (error, response, body) {
  if (!error && response.statusCode == 200) {
    console.log(body);
  }
}

request({ url: "https://link.goscore.me/api/1.0/loan_applications/1", headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" }}, callback)
curl -i -H "Content-Type: application/json" -H "Authorization: Bearer <token>" https://link.goscore.me/api/1.0/loan_applications/1
{
  "vehicles": {
  ...
  },
  "loans": [
  ...
  ],
  "personal": {
  ...
  },
  "income": {
  ...
  },
  "employment": "",
  "student_loan": {
  ...
  },
  "tax_documents": {
    "personal": {
      "tax_reports": [
        {
          "subject": "Skattemeldingen 2017",
          "filename": "Skattemelding 2017.pdf",
          "content": "data:application/pdf;base64,..."
        }
      ],
      "detailed_shares_data": [
        {
          "subject": "Detaljert Aksjeoppgave for 2021",
          "filename": "RF-1088D Detaljert.pdf",
          "content": "data:application/pdf;base64,..."
        }
      ],
      "business_assignment": [
        {
          "subject": "Næringsoppgave 2017",
          "filename": "Næringsoppgave 2 2017.pdf",
          "content": "data:application/pdf;base64,..."
        }
      ]
    },
    "corporate": {
      "<org_number>": {
        "latest_tax_report": [
          {
            "subject": "Skattemeldingen 2017",
            "filename": "Skattemelding 2017.pdf",
            "content": "data:application/pdf;base64,..."
          }
        ],
        "latest_annual_report": [
          {
            "subject": "Detaljert Aksjeoppgave for 2021",
            "filename": "RF-1088D Detaljert.pdf",
            "content": "data:application/pdf;base64,..."
          }
        ],
        "latest_shareholders_report": [
          {
            "subject": "Næringsoppgave 2017",
            "filename": "Næringsoppgave 2 2017.pdf",
            "content": "data:application/pdf;base64,..."
          }
        ]
      }
    }
  },
  "user_data_id": "36339d62-956c-4997-9cc0-3d6862c850da",
  "status": "done"
}

/loans/:id Edit

List all loans for a specified user consent by ID

Request params
page
(number) Page number. If not specified, first page is displayed.
per_page
(number) Page limit. Define how many items to display.

By default shows all loans for the User ID

Lists all the unsecured loans and student loan from Lånekassen collected for the selected User ID. Read more above about how to get a valid token.

Scope: unsecured_loans, student_loan

Loan object parameters

Parameter Description Required?
creditor_name name of the financial institution Yes
creditor_org_number company ID from the public register Yes
has_co_borrower (boolean) is this loan is shared with anyone else, has a co-borrower Yes
co_borrower (boolean) is current custoner a co-borrower for another person Yes
credit_limit credit car limit No
loan_amount original loan amount No
balance current loan balance No
charges monthly payment charges/fees No
charge_period perios applicable for chargees. Should be always “MONTHLY” if present No
type loan type. Could be one of the following options only: ‘credit_card’, ‘consumner_loan’, ‘charge_card’ Yes
nominal_rate nominal interest rate No
current_balance current loan balance, amount owned to the financial institution Yes
balance_with_interest balance used to calculate interest rate Yes
balance_without_interest balance with 0% nominal interest rate Yes
terms number of months for consumer loan No
kid unique identificator of payer for monthly payments No
account financial institution account number used to transfer money to No

Student loan object parameters

If the applicant isn’t customer at Lånekassen (never applied to get a loan), the response would be a blank hash "student_loan": {}

Parameter Description Required?
balance current loan balance No
fees current fees calculated No
charges additional fees charged No
interest interest calculated (in kr) No
status data collection status. If data is available, it returns ok, and if data isn’t available at Lånekassen anymore, you get unavailable No
status_reason Only if data isn’t available. The following statuses could be returned: moved_to_debt_collection, if the loan was permanently transferred to Statens Innkrevingssentral, terminated if loan is discarded, debt_settlement if debt settlement process initiated, or unrecognized if the reason isn’t available No
$.ajax({
  url: 'https://link.goscore.me/api/1.0/loans/1',
  data: {
    page: 2,
    per_page: 50
  }
  headers: {
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  method: 'GET',
  dataType: 'json',
  success: function(data){
    console.log('success: ' + data);
  }
});
r = requests.get("https://link.goscore.me/api/1.0/loans/1", headers={ "Authorization": "Bearer <token>", "Content-Type": "application/json" })
print r.text
var request = require("request");

function callback (error, response, body) {
  if (!error && response.statusCode == 200) {
    console.log(body);
  }
}

request({ url: "https://link.goscore.me/api/1.0/loans/1", qs: { page: 2, per_page: 50 }, headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" }}, callback)
curl -i -H "Content-Type: application/json" -H "Authorization: Bearer <token>" https://link.goscore.me/api/1.0/loans/1?page=2&per_page=50&active=true
{
  "loans": [
    {
      "creditor_name": "SPAREBANK 1 KREDITT AS",
      "creditor_org_number": 975966453,
      "has_co_borrower": false,
      "co_borrower": false,
      "credit_limit": 35000.0,
      "loan_amount": null,
      "balance": null,
      "charges": 0.0,
      "charge_period": "monthly",
      "type": "credit_card",
      "nominal_rate": 21.62,
      "current_balance": 349.0,
      "balance_with_interest": 0.0,
      "balance_without_interest": 349.0,
      "terms": 59,
      "kid": "012345677899",
      "account": "42024603940"
    },
    {
      "creditor_name": "RESURS BANK AB",
      "creditor_org_number": 984150865,
      "has_co_borrower": false,
      "co_borrower": false,
      "credit_limit": null,
      "loan_amount": 10176.63,
      "balance": 9842.06,
      "charges": 45.0,
      "charge_period": "monthly",
      "type": "consumner_loan",
      "nominal_rate": 6.17,
      "current_balance": 9842.06,
      "balance_with_interest": 0.0,
      "balance_without_interest": 0.0,
      "terms": 0.48,
      "kid": null,
      "account": '42026512345'
    },
    {
      "creditor_name": "BB - TF BANK NORGE",
      "creditor_org_number": 923194592,
      "has_co_borrower": false,
      "co_borrower": false,
      "credit_limit": 30000.0,
      "loan_amount": null,
      "balance": null,
      "charges": 0.0,
      "charge_period": "monthly",
      "type": "credit_card",
      "nominal_rate": 19.9,
      "current_balance": 0.0,
      "balance_with_interest": 0.0,
      "balance_without_interest": 0.0,
      "terms": null,
      "kid": null,
      "account": null
    },
    {
      "creditor_name": "AMERICAN EXPRESS EUROPE S A",
      "creditor_org_number": 920854346,
      "has_co_borrower": false,
      "co_borrower": false,
      "credit_limit": null,
      "loan_amount": null,
      "balance": null,
      "charges": null,
      "charge_period": null,
      "type": "charge_card",
      "nominal_rate": null,
      "current_balance": 29118.06,
      "balance_with_interest": 0.0,
      "balance_without_interest": 29118.06,
      "terms": null,
      "kid": null,
      "account": null
    }
  ],
  "student_loan": {
    "balance":367914.67,
    "fees":7910.0,
    "charges":0.0,
    "interest":39456.67,
    "status":"ok"
  },
  "user_data_id": "5c6985db-980b-4dba-a58e-c11faa5ea052",
  "status": "done"
}

/invoices/:id Edit

List all invoices (eFaktura) for a specified user consent by ID

Request params
page
(number) Page number. If not specified, first page is displayed.
per_page
(number) Page limit. Define how many items to display.

By default shows all invoices for the User ID

List all invoices from all banks (if user consent is given) sent to the consumer using efaktura

Scope: e_invoices

var settings = {
  "url": "https:/link.goscore.me/api/1.0/invoices/1",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json"
    "Authorization": "Bearer <insert your token here>"
  },
};

$.ajax(settings).done(function (response) {
  console.log(response);
});
import requests

url = "https:/link.goscore.me/api/1.0/invoices/1"

payload = {}
headers = {
  'Content-Type': 'application/json'
  'Authorization': 'Bearer <insert your token here>'
}

response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
var request = require('request');

var options = {
  'method': 'GET',
  'url': 'https:/link.goscore.me/api/1.0/invoices/1',
  'headers': {
    'Content-Type': 'application/json'
    'Authorization': 'Bearer <insert your token here>'
  }
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
curl --location --request GET 'https:/link.goscore.me/api/1.0/invoices/1' \
--header 'Content-Type: application/json' --header 'Authorization: Bearer <insert your token here>'
{
  "invoices": [
    {
      "id": "8599002184",
      "creditor_name": "EnterCard Kredittkort",
      "creditor_org_number": 918713867,
      "efaktura_ref": "123456789",
      "type": "INVOICE",
      "status": "PROCESSED",
      "account": "14300642641",
      "kid": "110002444955",
      "org_number": 918713867,
      "amount": 463.0,
      "min_amount": 400.0,
      "credit_note_amount": null,
      "due_date": "2021-01-16",
      "overdue": true,
      "paid": true
    },
  ],
  "user_data_id": "5c6985db-980b-4dba-a58e-c11faa5ea052",
  "status": "done"
}

/personal/:id Edit

Beta

Show personal customer data populated from the Folkeregisteret

Scope: info

Personal object parameters

Parameter Description Required?
first_name first name Yes
middle_name middle name No
last_name last name Yes
ssn ID- or D-number Yes
status DSF status Yes
birth_date birth date Yes
address full person’s address Yes
moving_date current address change date Yes
citizenships (array) person’s citizenship Yes
citizenship_country_codes (array) person’s citizenship in ISO 3-digit format Yes
norwegian_citizen (boolean) does person have norwegian citizenship Yes
norwegian_resident (boolean) is person a norwegian resident Yes
moved_to_norway_at date of first moving in Norway No
registered_residence (boolean) person’s residency is registered in DSF Yes
sex person’s sex, Available options: male, female Yes
kids number of kids under 18 Yes
marital_status public marital status. Available options: married, registered_partner, divorced, separated, widow, single NB: we’re working on adding cohabitant status as well Yes
living_conditions current living conditions based on the registtered address. Available options: rental, parents, own, housing_association Yes
cohabitant (boolean) has a registered partner Yes
additional_info BETA (dict, hash) additional information directly from the register No
var settings = {
  "url": "https:/link.goscore.me/api/1.0/personal/1",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer <insert your token here>"
  },
};

$.ajax(settings).done(function (response) {
  console.log(response);
});
import requests

url = "https:/link.goscore.me/api/1.0/personal/1"

payload = {}
headers = {
  'Content-Type': 'application/json'
  'Authorization': 'Bearer <insert your token here>'
}

response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
var request = require('request');

var options = {
  'method': 'GET',
  'url': 'https:/link.goscore.me/api/1.0/personal/1',
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <insert your token here>'
  }
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
curl --location --request GET 'https:/link.goscore.me/api/1.0/personal/1' \
--header 'Content-Type: application/json' --header 'Authorization: Bearer <insert your token here>'
{
  "personal": {
    "first_name": "OLA",
    "middle_name": null,
    "last_name": "NORDMANN",
    "ssn": "01018012345",
    "status": "bosatt",
    "birth_date": "1980-01-01",
    "address": "KONGENS GATE 1, 0123 OSLO",
    "moving_date": "2016-06-01",
    "citizenships": [
        "Norsk"
    ],
    "citizenship_country_codes": [
        "NOR"
    ],
    "norwegian_citizen": true,
    "norwegian_resident": true,
    "moved_to_norway_at": null,
    "registered_residence": true,
    "sex": "male",
    "kids": 0,
    "marital_status": "single",
    "living_conditions": "rental",
    "cohabitant": false
  },
  "user_data_id": "5c6985db-980b-4dba-a58e-c11faa5ea052",
  "status": "done"
}

/income/:id Edit

Beta

Customer income and employemnt information from a-meldinger (Skatteetaten)

Scope: income

Payslip object parameters

Parameter Description Required?
netto netto consumer income Yes
start_date employemnt started at Yes
end_date employment finished at No
laid_off (array) laid-off periods within the last 6 months No
fixed_wage deternimedd fixed wage level Yes
period_start starting of the paysliip period Yes
period_end ending of the paysliip period Yes
hourly_wage set hourly rate No
income_rows income positions included into the payslip No
income_rows.type income row type. Available options: fixed, vacation, other, hourly No
income_rows.hours number of hours, applicable for hourly paid jobs No
income_rows.amount amount No
income_rows.period income row period No
income_rows.benefit benefit paid as. Available options: kontantytelse, naturalytelse, utgiftsgodtgjoerelse No
payslip_type dominant payslip type, if several income rowss present. Available options: fixed, other, hourly Yes
total_payment brutto payment, incl taxed Yes
position_amount percent of the full-time position No
profession_code position profession code Yes
employer_org_num employer organizational number Yes
total_withholding_tax amount of taxes paid Yes

Employer object parameters

Parameter Description Required?
name organization name Yes
org_num organizational ID/number Yes
public (boolean) is public organization? Yes
current (bollean) is employment active? Yes
start_date emplyment started at Yes
end_date emplument finished at No
employment employemnt type. For the reference, please, see emplyment parameter above Yes
company_profile company registered information at Enhetsregisteret Yes

Employment parameter

Parameter Description Required?
employment overall employemnt type. Available options: fixed_public, fixed_private, self_employed, substitute, hired_consultant. NB: we’re working on adding the following options as well: retired, student, laid_off, household Yes
var settings = {
  "url": "https:/link.goscore.me/api/1.0/income/1",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer <insert your token here>"
  },
};

$.ajax(settings).done(function (response) {
  console.log(response);
});
import requests

url = "https:/link.goscore.me/api/1.0/income/1"

payload = {}
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer <insert your token here>'
}

response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
var request = require('request');

var options = {
  'method': 'GET',
  'url': 'https:/link.goscore.me/api/1.0/income/1',
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <insert your token here>'
  }
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
curl --location --request GET 'https:/link.goscore.me/api/1.0/income/1' \
--header 'Content-Type: application/json' --header 'Authorization: Bearer <insert your token here>'
{
  "income": {
    "payslips": [
      {
        "employer_org_num": "922707324",
        "fixed_wage": 22500.0,
        "hourly_wage": null,
        "total_withholding_tax": -4500.0,
        "total_payment": 22500.0,
        "netto": 18000.0,
        "payslip_type": "fixed",
        "period_start": "2020-03-01",
        "period_end": "2020-03-31",
        "income_rows": [
          {
            "type": "fixed",
            "hours": null,
            "amount": 22500.0,
            "period": "2020-03-01..2020-03-31",
            "benefit": "kontantytelse"
          }
        ],
        "profession_code": "1317111",
        "position_amount": 60.0,
        "start_date": "2020-03-01",
        "end_date": null,
        "laid_off": [],
      }
    ],
    "employers": [
      {
        "name": "GOSCORE AS",
        "public": false,
        "current": true,
        "org_num": "922707324",
        "employment": "fixed_private",
        "start_date": "2020-03-01",
        "end_date": null,
        "payslips": [
          {
            "netto": 18000.0,
            "end_date": null,
            "laid_off": [],
            "fixed_wage": 22500.0,
            "period_end": "2020-03-31",
            "start_date": "2020-03-01",
            "hourly_wage": null,
            "income_rows": [
              {
                "type": "fixed",
                "hours": null,
                "amount": 22500.0,
                "period": "2020-03-01..2020-03-31",
                "benefit": "kontantytelse"
              }
            ],
            "payslip_type": "fixed",
            "period_start": "2020-03-01",
            "total_payment": 22500.0,
            "position_amount": 60.0,
            "profession_code": "1317111",
            "employer_org_num": "922707324",
            "total_withholding_tax": -4500.0
          }
        ],
        "company_profile": {
          "id": "922707324",
          "raw": {
            "navn": "GOSCORE AS",
            "_links": {
              "self": {
                "href": "https://data.brreg.no/enhetsregisteret/api/enheter/922707324"
              }
            },
            "konkurs": false,
            "maalform": "Bokmål",
            "antallAnsatte": 1,
            "naeringskode1": {
              "kode": "62.020",
              "beskrivelse": "Konsulentvirksomhet tilknyttet informasjonsteknologi"
            },
            "stiftelsesdato": "2019-04-12",
            "underAvvikling": false,
            "organisasjonsform": {
              "kode": "AS",
              "_links": {
                "self": {
                  "href": "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/AS"
                }
              },
              "beskrivelse": "Aksjeselskap"
            },
            "forretningsadresse": {
              "land": "Norge",
              "adresse": [
                "Blekenberg 30"
              ],
              "kommune": "BERGEN",
              "landkode": "NO",
              "poststed": "BERGEN",
              "postnummer": "5055",
              "kommunenummer": "4601"
            },
            "organisasjonsnummer": "922707324",
            "institusjonellSektorkode": {
              "kode": "2100",
              "beskrivelse": "Private aksjeselskaper mv."
            },
            "registrertIMvaregisteret": false,
            "sisteInnsendteAarsregnskap": "2019",
            "registrertIForetaksregisteret": true,
            "registrertIStiftelsesregisteret": false,
            "registreringsdatoEnhetsregisteret": "2019-05-06",
            "registrertIFrivillighetsregisteret": false,
            "underTvangsavviklingEllerTvangsopplosning": false
          },
          "code": "2100",
          "name": "GOSCORE AS",
          "address": {
            "city": "BERGEN",
            "postal_code": "5055",
            "street_address": "Blekenberg 30"
          },
          "org_form": "AS",
          "employees": 1,
          "founded_at": 1557093600,
          "country_code": "NO"
        }
      }
    ]
  },
  "employment": "fixed_private",
  "user_data_id": "5c6985db-980b-4dba-a58e-c11faa5ea052",
  "status": "done"
}

/vehicles/:id Edit

Beta

List all vehicles registered on the costumer name from Statens Vegvesen

Scope: vehicles

Vehicle information object parameters

Parameter Description Required?
vehicle_information (array) list of the registered vehicles with plate numbers. First value is a vehicle name, second - plate number No

NB! Additional information in vehicles_detailed might be missing in some cases.

var settings = {
  "url": "https:/link.goscore.me/api/1.0/vehicles/1",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer <insert your token here>"
  },
};

$.ajax(settings).done(function (response) {
  console.log(response);
});
import requests

url = "https:/link.goscore.me/api/1.0/vehicles/1"

payload = {}
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer <insert your token here>'
}

response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
var request = require('request');

var options = {
  'method': 'GET',
  'url': 'https:/link.goscore.me/api/1.0/vehicles/1',
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <insert your token here>'
  }
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
curl --location --request GET 'https:/link.goscore.me/api/1.0/vehicles/1' \
--header 'Content-Type: application/json' --header 'Authorization: Bearer <insert your token here>'
{
  "vehicles": {
    "first_name": "OLA",
    "middle_name": null,
    "last_name": "NORDMANN",
    "email": "ola.nordmann@gmail.com",
    "digital_mailbox": "DIGIPOST",
    "phone_number": "91234567",
    "birth_date": "1980-01-01",
    "vehicles": [
      ["DMC DeLorean (1967)", "OUTATIME"],
      ["Mercedes C180 Kompressor (2019)", "UR 10000"]
    ],
    "vehicles_detailed": [
        {
          "model_name": "Mercedes-Benz C300",
          "type": "personal_car",
          "type_code": "M1",
          "year": 2019,
          "plate_number": "UR 10000",
          "electric": false,
          "hybrid": false,
          "last_eu_control": "2019-11-08",
          "next_eu_control": "2021-11-08",
          "owned": true,
          "owner": {
            "name": "Ola Nordmann",
            "address": {
              "land": "Norge",
              "poststed": "Oslo",
              "postnummer": "0123",
              "adresselinje1": "Kongens gate 1",
              "adresselinje2": null,
              "adresselinje3": null
            }
          },
          "co_owned": false,
          "co_ownership": {
            "name": "",
            "address": null
          },
          "leased": false,
          "leasing": {
            "name": "",
            "address": null
          },
          "technical_details": {
            "emissions": {
              "environmental_class": "5L",
              "engines": [
                {
                  "co2": 139,
                  "nox": 135.8
                }
              ]
            },
            "engines": [
              {
                "type": "diesel",
                "volume": 1968
              }
            ]
          }
        },
        {
          "model_name": "DeLorean",
          "type": "atv",
          "type_code": "MR",
          "year": 1967,
          "plate_number": "OUTATIME",
          "electric": false,
          "hybrid": false,
          "last_eu_control": null,
          "next_eu_control": null,
          "owned": true,
          "owner": {
            "name": "Ola Nordmann",
            "address": {
              "land": "Norge",
              "poststed": "Oslo",
              "postnummer": "0123",
              "adresselinje1": "Kongens gate 1",
              "adresselinje2": null,
              "adresselinje3": null
            }
          },
          "co_owned": false,
          "co_ownership": {
            "name": "",
            "address": null
          },
          "leased": false,
          "leasing": {
            "name": "",
            "address": null
          },
          "technical_details": {
            "emissions": {
              "environmental_class": null,
              "engines": [
                {
                  "co2": null,
                  "nox": null
                }
              ]
            },
            "engines": [
              {
                "type": "petrol",
                "volume": 280
              }
            ]
          }
        }
      ]
  }
  "user_data_id": "5c6985db-980b-4dba-a58e-c11faa5ea052",
  "status": "done"
}