DataFabric API Documentation

Get optimized routes and turn-by-turn directions between locations.

GET /api/v1/routes/directions

{
  "status": "success",
  "data": {
    "distance": "382.5 km",
    "duration": "3h 45m",
    "steps": [...]
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Rate Limit: Depends on your plan (10-120 req/min)

Cost: $0.005 per request on metered plans

Render map tiles and generate static map images.

GET /api/v1/maps/tiles/{z}/{x}/{y}

Returns a map tile image for the specified zoom level and coordinates.

GET /api/v1/maps/static

Generate a static map image with markers and overlays.

Comprehensive Know Your Customer verification with AI-powered document OCR, identity checks, risk scoring, and compliance screening.

{
  "user_reference": "user_12345",
  "first_name": "John",
  "last_name": "Doe",
  "date_of_birth": "1990-05-15",
  "document_type": "passport",
  "document_number": "AB123456",
  "country": "US",
  "email": "john@example.com",
  "phone": "+1234567890",
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "postal_code": "10001",
    "country": "US"
  },
  "webhook_url": "https://your-app.com/webhooks/kyc",
  "metadata": {
    "order_id": "ORD-123"
  }
}

{
  "status": "success",
  "check_id": "550e8400-e29b-41d4-a716-446655440000",
  "result": "approved",
  "kyc_status": "completed",
  "risk_score": "low",
  "verification_details": {
    "checks": {
      "document_valid": true,
      "age_verified": true,
      "identity_verified": true,
      "watchlist_clear": true,
      "pep_check": false
    }
  },
  "expires_at": "2025-12-27T10:30:00Z",
  "request_id": "req_xyz789"
}

Content-Type: multipart/form-data

image: [file] (JPEG, PNG, WebP, max 10MB)
image_type: "front" | "back" | "selfie" | "proof_of_address"
auto_extract: true (enable AI OCR)

curl -X POST "https://datafabric.hiroshiaki.com/api/v1/kyc/checks/{check_id}/documents" \
  -H "X-Api-Key: your_api_key" \
  -F "image=@/path/to/ic_front.jpg" \
  -F "image_type=front" \
  -F "auto_extract=true"

{
  "status": "success",
  "document": {
    "id": 1,
    "image_type": "front",
    "has_ocr_data": true,
    "ocr_data": {
      "document_type": "national_id",
      "full_name": "Ahmad Ibrahim bin Abdullah",
      "first_name": "Ahmad",
      "last_name": "Ibrahim",
      "id_number": "950320-10-5678",
      "date_of_birth": "1995-03-20",
      "gender": "male",
      "nationality": "Malaysian",
      "address": "Jalan Bukit Bintang, KL 50200",
      "confidence": 95,
      "provider": "openrouter_ai"
    }
  }
}

Access and manage user information securely.

GET /api/v1/users/{id}

Retrieve user profile information.

PATCH /api/v1/users/{id}

Update user profile information.

Cost: $0.002 per request

Integrate DataFabric API with our official SDKs for PHP, JavaScript, and Python.

composer require hiroshiaki/datafabric-sdk-php

npm install @datafabric/sdk-js

pip install datafabric-sdk

use DataFabric\SDK\KycClient;

$client = new KycClient('your_api_key');

$response = $client->createCheck([
    'first_name' => 'John',
    'last_name' => 'Doe',
    'date_of_birth' => '1990-05-15',
    'document_type' => 'passport',
    'document_number' => 'AB123456'
]);

if ($response->isApproved()) {
    echo "✅ KYC Approved!";
}

Receive real-time notifications for KYC check completions and other events.

{
  "event": "kyc.check.completed",
  "check_id": "550e8400-e29b-41d4-a716-446655440000",
  "result": "approved",
  "risk_score": "low",
  "occurred_at": "2025-11-27T10:30:00Z"
}

Configuration: Set webhook_url when creating KYC checks

When an error occurs, the API returns a JSON response with error details:

{
  "status": "error",
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid or has been revoked"
  },
  "request_id": "req_abc123"
}