Company Information Check
The Company Information Check API allows merchants and partners to retrieve the verification history and details of a specific company. By querying a company’s ID, you can access data such as past verification attempts, credit scores, risk levels, and contact information verified via BankID. This enables better decision-making for credit risk assessment, compliance, and onboarding.
Use Cases
- Audit Trails: Review past verification events and maintain a log for compliance.
- Credit Assessment: Understand previous credit ratings and risk levels before extending services.
- Compliance Reporting: Meet KYC and AML requirements with verifiable data records.
- Troubleshooting: Investigate previously initiated checks for support and debugging.
Endpoint
GET https://demo-api.frontpayment.no/api/v1/connect/company/details/{company_id}
Replace {company_id} with the numeric identifier of the company.
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 response returns 200 OK with the company’s verification history.
Example Response
{
"status_code": 200,
"status_message": "OK",
"message": "companyRecordRetriveSuccessfully",
"is_data": true,
"data": [
{
"companyCheckUuid": "COMCHK1754819969",
"companyId": "920058272",
"companyType": "BRL",
"companyName": "FLØTNINGEN PARK II BORETTSLAG",
"score": "856",
"riskLevel": "Low",
"scoreMessage": "Good Credit Rating",
"defaultProbability": "0.44",
"personalNumber": "28038712383",
"contactPersonName": "Georg Bøe",
"contactPersonEmail": "[email protected]",
"createdAt": 1754819969
}
]
}
Field Descriptions
| Parameter | Type | Description |
|---|---|---|
companyCheckUuid |
string |
The UUID you received when initiating the call. |
companyId |
string |
The verified company’s ID. |
companyType |
string |
The type/category of the company. |
companyName |
string |
The legal name of the company. |
score |
number |
The company’s credit score. |
riskLevel |
string |
The risk level based on the credit score. |
scoreMessage |
string |
Message providing context about the credit score. |
defaultProbability |
number |
Probability of default based on credit assessment. |
personalNumber |
number |
Personal number retrieved from BankID. |
contactPersonName |
string |
Full name of the contact person from BankID. |
contactPersonEmail |
string |
Email address of the contact person from BankID. |
createdAt |
number |
Unix timestamp of when the company check was created. |
Notes
- The response array may contain multiple records if the company has undergone multiple checks.
- Ensure secure handling of all personal and company data to maintain compliance with privacy laws.
- For questions or demo access, contact nafees.faraz@frontpayment.no.