Skip to main content
API Preview
Developers

REST API/Identity

Identity

Identity claim flow for verifying and linking individual identities.

2 endpoints

Endpoints

MethodPathAuth
POST/identity/claim

Claim an identity stub

Public
GET/identity/stub/{claim_code}

Get public stub info

Public

Endpoint Details

GET /identity/stub/{claim_code}

GET/identity/stub/{claim_code}Public

Returns anonymous stub info for the claim page - trait count, query count, accrued earnings, and status. No authentication required.

Path Parameters

NameTypeDescription
claim_code*stringThe claim code (e.g., ALT-K7X9M2)

Response

json
{
  "claim_code": "ALT-K7X9M2",
  "trait_count": 14,
  "query_count": 3,
  "accrued_earnings": 0.48,
  "attunement_band": "Growing",
  "created_at": "2026-03-05T12:00:00Z",
  "status": "unclaimed"
}

POST /identity/claim

POST/identity/claimPublic

Claim an anonymous identity stub by providing email, password, and ToS acceptance. Creates a user account, activates the stub, and returns JWT tokens with earnings summary.

Request Example

json
{
  "claim_code": "ALT-K7X9M2",
  "email": "jane@example.com",
  "password": "S3cure!Pass#2026",
  "tos_accepted": true
}

Response

json
{
  "access_token": "eyJhbGciOiJFUzI1NiIs...",
  "token_type": "bearer",
  "expires_in": 3600,
  "user": {
    "id": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
    "email": "jane@example.com",
    "role": "member"
  },
  "member_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "earnings_summary": {
    "total_earned": 0.48,
    "pending_amount": 0.16,
    "transaction_count": 3
  }
}