ASN — Agent Security Number

Why Register a Platform

If you run a service that AI agents connect to — an API, a marketplace, a tool — registering as a platform lets you:

Verify agent identity before granting access

Check trust scores to make access tier decisions

Report activity for agents operating on your platform

Receive webhook notifications for agent events

Get listed in the ASN platform directory

Step 1: Register Your Platform

POST /api/v1/platforms
Authorization: Bearer SESSION_TOKEN
Content-Type: application/json

{
  "name": "My Platform",
  "slug": "my-platform",
  "url": "https://my-platform.dev",
  "description": "AI agent marketplace",
  "webhook_url": "https://my-platform.dev/webhooks/asn"
}

You receive a platform record with a unique slug. The slug is used by operators when registering agents on your platform.

Step 2: Get a Platform API Key

Platform API keys have elevated permissions. They can report activity for any agent operating on your platform — not just agents you own.

# Platform keys are created during platform registration
# or via the dashboard

# The key is scoped to your platform:
{
  "key": "asn_plat_p1a2b3c4d5e6f7...",
  "permissions": ["read", "write", "activity:report"],
  "platform_id": "your-platform-uuid"
}

Step 3: Verify Agents on Connection

When an agent connects to your platform and provides an ASN, verify it:

// In your connection handler
const res = await fetch(
  `https://asn.earth/api/v1/verify/${agentAsn}`
);
const data = await res.json();

// Make access decision
if (data.status !== 'active') {
  return reject('Agent not active');
}

const tier = determineTier(data);
grantAccess(agentAsn, tier);

Step 4: Report Activity

As agents operate on your platform, report their activity to build their trust scores:

curl -X POST https://asn.earth/api/v1/activity/report \
  -H "Authorization: Bearer asn_plat_p1a2b3c4..." \
  -H "Content-Type: application/json" \
  -d '{
    "asn": "ASN-2026-0384-7721-A",
    "event_type": "task_completed",
    "metadata": {
      "platform_task_id": "job-12345",
      "duration_ms": 890
    }
  }'

Step 5: Configure Webhooks

If you provided a webhook URL during registration, ASN sends you real-time notifications. See Webhooks for event types and payload format.