Credit Check
Credit Check for Private Customer
Use this API to perform a credit assessment for a private individual (a consumer) based on their social security number (Personal Number).
Endpoint
POST https://demo-api.frontpayment.no/api/v1/connect//credit/check/private
Authentication
Include a Bearer Token in the Authorization header. You can obtain this token from Front Payment.
Example:
Authorization: Bearer YOUR_FRONTPAYMENT_BEARER_TOKEN
Request Payload
Send the following parameters as a JSON object in the request body:
{
"personalId": "993344228",
"countryCode": +47,
"msisdn": 46xxxxxx45
}
Validation Rules
Make sure your request meets the following requirements:
| Field | Type | Description |
|---|---|---|
personalId |
string |
Required Personal Number. |
countryCode |
string |
Optional Country code for the customer's phone number (e.g., "+47"). |
msisdn |
string |
Optional Mobile Subscriber ISDN Number (phone number). |
Response
A successful request will return a 200 OK status with the following JSON payload:
"status_code": 200,
"status_message": "OK",
"message": "creditCheckRequestedSuccessful",
"is_data": false,
"data": null
}
API returns a 500 or 510 error, it means something failed on the server side
{
"status_code": 510,
"status_message": "Execution Exception Occurred",
"message": "somethingWentWrong",
"is_error": true,
"errors": "Array"
}
Credit Check for Corporate Customer
This API performs a credit assessment for a corporate customer (a business or company) based on its organization number.
Endpoint
POST https://demo-api.frontpayment.no/api/v1/connect//credit/check/corporate
Authentication
Include a Bearer Token in the Authorization header. You can obtain this token from Front Payment.
Example:
Authorization: Bearer YOUR_FRONTPAYMENT_BEARER_TOKEN
Request Payload
Send the following parameters as a JSON object in the request body:
{
"organizationId": "993344228",
}
Validation Rules
Make sure your request meets the following requirements:
| Field | Type | Description |
|---|---|---|
organizationId |
string |
Required The official organization number of the company. |
Response
A successful request will return a 200 OK status with the following JSON payload:
"status_code": 200,
"status_message": "OK",
"message": "creditCheckRequestedSuccessful",
"is_data": false,
"data": null
}
API returns a 500 or 510 error, it means something failed on the server side
{
"status_code": 510,
"status_message": "Execution Exception Occurred",
"message": "somethingWentWrong",
"is_error": true,
"errors": "Array"
}
Get Credit Check List
This API allows your application to retrieve a list of all credit checks.
Endpoint
GET https://demo-api.frontpayment.no/api/v1/connect//credit/check/list
Authentication
Include a Bearer Token in the Authorization header. You can obtain this token from Front Payment.
Example:
Authorization: Bearer YOUR_FRONTPAYMENT_BEARER_TOKEN
Response
A successful request will return a 200 OK status with the following JSON payload:
{
"status_code": 200,
"status_message": "OK",
"message": "creditCheckHistoryRetrievedSuccessfully",
"is_data": true,
"data": [
{
"date": "19.03.2025",
"name": "MONRAD SIV NINA",
"type": "Private",
"companyType": null,
"organizationId": null,
"personalNumber": "04*******85",
"countryCode": "+47",
"msisdn": null,
"defaultProbability": "15% - 27%",
"score": 441,
"scoreMessage": "High to moderate risk, credit up to NOK 20,000 can be approved",
"riskLevel": "Moderate"
},
{
"date": "15.03.2025",
"name": "KNUTSMOEN EIENDOM ANS",
"type": "Corporate",
"companyType": "ANS",
"organizationId": "998379342",
"personalNumber": null,
"countryCode": null,
"msisdn": null,
"defaultProbability": "0",
"score": 0,
"scoreMessage": "Credit information could not be retrieved",
"riskLevel": "High"
}
]
}
API returns a 510 error, it means something failed on the server side
{
"status_code": 510,
"status_message": "Execution Exception Occurred",
"message": "Something Went Wrong",
"is_error": true,
"errors": "Array"
}