DEVELOPER DOCUMENTATION

API Documentation

Everything you need to deploy with Runles. Build, deploy, and scale your applications with our powerful API.

Getting Started

The Runles API is organized around REST. Our API accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes.

Base URL
https://api.baselayer.com

Authentication

Authenticate your API requests by including your API key in the Authorization header. You can find your API keys in the Dashboard.

bash
curl https://api.baselayer.com/v1/business/verify \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json"

Security Notice

Keep your API keys secure. Do not share them in publicly accessible areas such as GitHub or client-side code.

Example: Verify a Business

Here's a complete example of verifying a business entity.

bash
curl -X POST https://api.baselayer.com/v1/business/verify \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "business": {
      "name": "Acme Corporation",
      "ein": "12-3456789",
      "address": {
        "street": "123 Market Street",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94105"
      }
    },
    "checks": ["identity", "sanctions", "credit"]
  }'

Response

json
{
  "id": "biz_8x9y2z3a4b5c",
  "status": "verified",
  "risk_score": 15,
  "checks": {
    "identity": { "status": "pass", "confidence": 0.98 },
    "sanctions": { "status": "clear", "matches": [] },
    "credit": { "status": "pass", "score": 720 }
  },
  "created_at": "2024-01-15T10:30:00Z"
}

Webhooks

Runles can send webhook events to notify your application when verification results are ready or when risk scores change.

verification.completed
verification.failed
risk_score.changed
watchlist.match

Rate Limits

The API has rate limits to ensure fair usage and system stability.

PlanRequests/minRequests/day
Starter601,000
Growth30010,000
EnterpriseRECOMMENDEDUnlimitedUnlimited

Need help?

Our team is here to help you get started with Runles.