Search
K
🚀

Get Started with C&F APIs

Follow these steps to integrate C&F insurance APIs into your application in minutes.

50+APIs
6Easy Steps
200+Years Trust
1

Sign Up for an Account

Create your C&F Developer Portal account to begin.

  • Provide your name and email address
  • Submit your registration request
Sign Up Now →
2

Confirm Your Email & Set Password

Verify your email address and create a secure password.

  • Check your inbox for a confirmation email from C&F
  • Click the verification link
  • Set a strong password for your account
⏱️ Typical Time: 2-5 minutes
3

Wait for Admin Approval

Our team will review and approve your access request.

  • C&F administrators review your registration
  • You'll receive an email notification once approved
  • Approval typically takes 1-2 business days
📧 Check your email: We'll notify you as soon as your account is approved.
4

Log In and Explore the API Catalog

Once approved, log in to access the developer portal and browse available APIs and their documentation.

  • Use your email and password to sign in
  • Browse available APIs and their documentation
  • View API endpoints, parameters, and response formats
  • Read integration guides and code examples
  • Understand rate limits and authentication methods
Log In →
5

Register for Specific APIs

Request access to the APIs you need for your integration.

  • Select the APIs you want to use
  • Click "Request Access" for each API
  • Receive your OIDC client credentials (Client ID and Client Secret)
🔑 Credentials: Your OIDC credentials will be ready to use once your API request has been approved by our admin.
6

Test Your Integration

Use our sandbox environment to test your API calls safely.

  • Access the sandbox with test credentials
  • Make test API calls without affecting production data
  • Verify responses and error handling
  • Debug your integration
✅ Best Practice: Always test thoroughly in sandbox before moving to production.

🔒 OIDC Authentication Overview

C&F APIs use OpenID Connect (OIDC) for secure authentication. Once you have API access, you'll authenticate using the client credentials flow.

Step 1: Obtain Access Token

Request an access token using your Client ID and Client Secret:

curl -X POST https://auth.apis.cfins.io/oauth2/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials" \ -d "client_id=YOUR_CLIENT_ID" \ -d "client_secret=YOUR_CLIENT_SECRET"

Example Response:

{ "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...", "token_type": "Bearer", "expires_in": 3600 }

Step 2: Use Token in API Requests

Include the access token in the Authorization header:

curl -X GET https://api.cfins.io/v1/policies \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json"

Example Response:

{ "policy_id": "POL-12345", "status": "active", "effective_date": "2024-01-01" }
⏰ Token Expiration: Access tokens expire after the time specified in expires_in (typically 1 hour). Request a new token when needed using the same credentials.
📖 Learn More: For detailed OIDC implementation guides, security best practices, and code examples, visit Authentication Documentation.