# 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  
```http
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  
```json
{
  "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](mailto:nafees.faraz@frontpayment.no)**.