Quickstart

Get Started

Perform your first compliance check with the KYC API in three simple steps.

Step 1: Get Your API Credentials

Contact your account administrator to obtain API credentials. You’ll receive either:

JWT Token (for user applications)

Temporary tokens issued through your authentication provider (Cognito). Ideal for web applications and mobile apps.Validity: Typically 1 hour
Best for: User-facing applications, frontend integrations

API Key (for server integrations)

Permanent credentials for machine-to-machine integrations.Format: sk_xxxxxxxxxxxxxxxx
Best for: Backend services, automated integrations, scheduled jobs

Store API keys securely in environment variables or secrets manager.

Step 2: Choose Your Environment

Select the appropriate environment for your needs:

Environment	URL	Purpose
Staging	`https://stg.kyc.legaltalent.ai`	Testing and integration
Production	`https://kyc.legaltalent.ai`	Live operations

Start with Staging for development and testing. Move to Production when you’re ready to go live.

Step 3: Make Your First Request

Check an entity against the OFAC sanctions list:

curl -X POST https://stg.kyc.legaltalent.ai/kyc \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": {
      "full_name": "John Doe",
      "nationality": "US"
    },
    "list_name": "ofac",
    "search_type": "composite"
  }'

Success Response

{
  "status": "success",
  "result": {
    "is_match": false,
    "list_name": "ofac",
    "match_count": 0,
    "matches": [],
    "processing_time_ms": 850
  },
  "execution_context": {
    "request_id": "abc-123-def",
    "timestamp": "2024-11-22T10:30:00Z"
  }
}

No match found - Entity is clear from OFAC sanctions.

Match Found

{
  "status": "success",
  "result": {
    "is_match": true,
    "list_name": "ofac",
    "match_count": 1,
    "matches": [
      {
        "entity_id": "12345",
        "name": "John Doe",
        "confidence_score": 0.95,
        "match_type": "composite",
        "programs": ["SDGT"]
      }
    ],
    "processing_time_ms": 1250
  }
}

Match found - Entity appears on OFAC sanctions list. Review required.

Common Use Cases

Now that you’ve made your first request, explore common integration patterns:

Check Multiple Lists

Screen against OFAC, UN, and EU lists simultaneously.

Crypto Wallet Screening

Validate cryptocurrency wallet addresses against sanctions.

Adverse Media Checks

AI-powered screening for negative news and risk factors.

Ongoing Monitoring

Set up automated watchlist monitoring with alerts.

Next Steps

Review Authentication

Learn about JWT tokens vs API keys and permission requirements.

Explore Endpoints

Browse the full API reference for all available features.

Understand Rate Limits

Review rate limiting and WAF protection to optimize your integration.

Export Results

Generate PDF reports for compliance documentation.

Production Checklist

✅ Use Production API keys (not Staging keys)
✅ Implement proper error handling
✅ Store credentials securely
✅ Monitor usage metrics
✅ Set up webhook endpoints for watchlist alerts

Getting Started

Guides

Claude Connector

Legal

Get Started

Step 1: Get Your API Credentials

Step 2: Choose Your Environment

Step 3: Make Your First Request

Common Use Cases

Check Multiple Lists

Crypto Wallet Screening

Adverse Media Checks

Ongoing Monitoring

Next Steps

​Get Started

​Step 1: Get Your API Credentials

​Step 2: Choose Your Environment

​Step 3: Make Your First Request

​Common Use Cases

Check Multiple Lists

Crypto Wallet Screening

Adverse Media Checks

Ongoing Monitoring

​Next Steps

Get Started

Step 1: Get Your API Credentials

Step 2: Choose Your Environment

Step 3: Make Your First Request

Common Use Cases

Next Steps