API Integration Tutorials

Step-by-step guides to connect your system with CRiskCo's risk and compliance intelligence.

Step-by-Step Guides

1. Get Your API Key

Register on the CRiskCo portal to obtain your API credentials. You'll receive a client_id and client_secret for authentication.

POST /oauth/token
Content-Type: application/json

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "grant_type": "client_credentials"
}

2. Authentication

Use OAuth 2.0 client credentials to get an access token. Include the token in the Authorization header of every request.

// Response
{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

// Use in requests
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

3. Query a Company Report

With your token, query credit risk, compliance, and exposure reports for any company registered in Mexico using their RFC (tax ID).

GET /api/v2/company/report?rfc=XAXX010101000
Authorization: Bearer {access_token}

// Response
{
  "company": {
    "rfc": "XAXX010101000",
    "name": "Empresa Demo S.A. de C.V.",
    "fin_score": 78,
    "compliance_status": "active",
    "blacklist_flags": []
  }
}

4. Continuous Monitoring

Set up webhooks to receive alerts when risk or compliance indicators change for the companies you monitor.

POST /api/v2/webhooks
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "url": "https://your-app.com/webhook",
  "events": [
    "compliance.status_changed",
    "risk.score_changed",
    "blacklist.flag_added"
  ]
}

5. Integrate with Your System

Use our SDKs or call the REST API directly. We support integration with any programming language and platforms like Zapier.

// Node.js example
const response = await fetch(
  'https://api.criskco.com/api/v2/company/report?rfc=XAXX010101000',
  {
    headers: {
      'Authorization': `Bearer ${accessToken}`,
      'Content-Type': 'application/json'
    }
  }
);

const report = await response.json();
console.log(report.company.fin_score);