Skip to main content
API Preview
Developers

REST API/Credential Queries

Credential Queries

x402-gated identity queries with audit trail.

5 endpoints

Endpoints

MethodPathAuth
PUT/orgs/queries/consent/category

Update category consent

JWT
GET/orgs/queries/consent/config

Get consent configuration

JWT
POST/orgs/queries/credential

Query member credentials

x402
GET/orgs/queries/earnings/history

Get paginated earnings history

JWT
GET/orgs/queries/earnings/summary

Get earnings summary with analytics

JWT

Endpoint Details

POST /orgs/queries/credential

POST/orgs/queries/credentialx402

x402-gated endpoint for organisations to query member identity data. Returns pseudonymised trait tiers (never numeric scores). Verifies consent, enforces rate limits, records transaction for Identity Income.

Request Example

json
{
  "member_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "data_type": "trait_profile"
}

Response

json
{
  "data": {
    "member_pseudonym": "ALT-7X9K",
    "archetype": "Architect",
    "trait_tiers": {
      "adaptive_capacity": "high",
      "cognitive_style": "strong",
      "interpersonal_orientation": "moderate",
      "drive_architecture": "high",
      "integrity_trust": "strong"
    },
    "data_completeness": "comprehensive"
  },
  "query_metadata": {
    "data_type": "trait_profile",
    "payment_type": "x402",
    "remaining_daily_queries": 47,
    "consent_level": "full"
  }
}

GET /orgs/queries/earnings/summary

GET/orgs/queries/earnings/summaryJWT

Returns the member's Identity Income summary with monthly breakdown and top-earning trait categories.

GET /orgs/queries/earnings/history

GET/orgs/queries/earnings/historyJWT

Returns paginated transaction history for the member.

Query Parameters

NameTypeDescription
limitintegerPage size (default 20)
offsetintegerOffset for pagination