Skip to main content

Company Information Check

Introduction

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://stg-api.frontpayment.no/api/v1/connect/company/details/{company_id}

Description

Use this endpoint to retrieve detailed verification information about a company. 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 [email protected].
Back to top