</>Developer Documentation

Build on WYRR

108+ RESTful API endpoints across 7 protocol layers. Smart Tags, AI World Brain, NFT minting, fraud detection, and more. Full API access on Pro and Enterprise plans.

108+ endpoints|6 API domains|46 AI endpoints|44 Tag endpoints

API Reference

RESTful endpoints organized by domain

Identity

/api/v1/identity12 endpoints
POST/create
GET/:did
POST/:did/verify
PUT/:did/profile
POST/:did/credentials
GET/:did/credentials

NFT & Assets

/api/v1/nft10 endpoints
POST/mint
POST/transfer
POST/burn
GET/balance/:address
PUT/metadata/:tokenId

Smart Tags

/api/v1/tags44 endpoints
POST/register
POST/resolve
POST/actions/execute
GET/nearby
POST/batch/generate
POST/overlay/render

AI World Brain

/api/v1/ai46 endpoints
POST/opportunities/rank
POST/fraud/detect
POST/flow/optimize
POST/roles/match
GET/spatial/heatmap
POST/rewards/optimize

Campaigns & Quests

/api/v1/campaigns18 endpoints
POST/create
POST/:id/deploy
POST/:id/claim
POST/quests/create
GET/quests/leaderboard

Revenue & Payments

/api/v1/revenue18 endpoints
POST/subscribe
POST/tags/order
POST/escrow/create
POST/escrow/release
GET/balance

Quick Start

Get up and running in minutes

javascript
const response = await fetch('https://api.wyrr.io/v1/identity/create', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    type: 'individual',
    profile: {
      displayName: 'Alice',
      bio: 'Delivery driver in San Francisco',
    },
    verification: {
      method: 'biometric',
      data: biometricPayload,
    },
  }),
});

const { did, credentials } = await response.json();
console.log('Created DID:', did);
// => "did:wyrr:sf:abc123..."

Authentication

Secure your API requests

API Key Authentication

Include your API key in the Authorization header of every request. API keys are scoped to your organization and can be rotated at any time.

Authorization: Bearer wyrr_live_abc123...

OAuth 2.0 (Coming Soon)

For user-facing integrations, we support OAuth 2.0 with PKCE. Users authorize your app to act on their behalf with fine-grained permission scopes.

identity:readflows:writetags:managespheres:admin

SDKs & Libraries

Native SDKs for your preferred language

JS

JavaScript / Node.js

Available
SW

Swift (iOS)

Available
C#

Unity (C#)

Available
PY

Python

Coming Soon
KT

Kotlin (Android)

Coming Soon
GO

Go / Rust

Coming Soon

Integration Examples

Common patterns and recipes

Delivery Verification

Use Smart Tags to create proof-of-delivery flows with automatic payment settlement.

TagsFlowsPayments

Marketplace Escrow

Build a marketplace with programmable escrow that settles on buyer confirmation.

FlowsIdentityPayments

Asset Tracking

Track physical assets through their lifecycle with tamper-proof NFC tag events.

TagsIdentitySpheres

Event Check-in

Tap-to-check-in with identity verification and automatic badge issuance.

TagsIdentitySpheres

Fleet Management

Manage driver assignments, routes, and settlements across your fleet.

NetworkFlowsTags

Loyalty Program

Build tap-to-earn loyalty with Smart Tags at physical locations.

TagsSpheresPayments

Ready to Integrate?

API access is available on Enterprise plans. Start with Explorer to test the platform, then upgrade for full API access.