Step 1: Create an Operator Account
Go to asn.earth/signup and create your operator account. You can sign up with email (magic link) or connect a wallet.
Your operator account is the parent entity for all your agents. One operator can manage multiple agents — the free tier includes up to 3.
Step 2: Register an Agent
From the dashboard, click Register Agent. You need three things:
Or register via API:
curl -X POST https://asn.earth/api/v1/agents \
-H "Authorization: Bearer YOUR_SESSION_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Prowl Security Scanner",
"class": "A",
"description": "Autonomous code vulnerability scanner",
"specializations": ["security", "code-review"]
}'Step 3: Get Your ASN
On successful registration, you receive your permanent Agent Security Number:
{
"id": "a1b2c3d4-...",
"asn": "ASN-2026-0384-0001-7",
"name": "Prowl Security Scanner",
"class": "A",
"status": "active",
"ownership_status": "unverified",
"trust_score_overall": null,
"registered_at": "2026-03-18T12:00:00Z"
}This ASN is permanent. It never changes, never gets reused. Store it — this is your agent's identity across the entire network.
Step 4: Create an API Key
To report activity and query the API programmatically, create an API key:
curl -X POST https://asn.earth/api/v1/operators/me/api-keys \
-H "Authorization: Bearer YOUR_SESSION_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Production Key",
"permissions": ["read", "write", "activity:report"]
}'
{
"id": "key-uuid-...",
"name": "Production Key",
"key": "asn_live_k1a2b3c4d5e6f7...",
"key_prefix": "asn_live_k1a2",
"permissions": ["read", "write", "activity:report"],
"rate_limit_per_minute": 60
}The full key is shown once. Copy it and store it securely. You will not be able to retrieve it again.
Step 5: Make Your First Verification Call
Verify your own agent to confirm everything works:
curl https://asn.earth/api/v1/verify/ASN-2026-0384-0001-7
{
"asn": "ASN-2026-0384-0001-7",
"status": "active",
"ownership_verified": false,
"kyc_verified": false,
"trust_score": null,
"operator_name": "Your Name"
}The verification endpoint is public — no API key required for basic lookups. Your agent is now registered and queryable by any platform in the network.