REST API/People
People
Individual profile management, consent settings, and discovery flow.
12 endpoints
Endpoints
Endpoint Details
GET /members/me
/members/meJWTReturns the authenticated member profile including assessment phase, engagement level, and account status.
Response
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"external_id": "MBR-A1B2C3D4",
"display_name": "Jane",
"assessment_phase": "complete",
"account_status": "active",
"engagement_level": 3,
"created_at": "2026-03-01T10:00:00Z",
"profile": {
"current_industry": "Technology",
"years_experience": 8,
"education_level": "bachelors",
"location_country": "AU"
}
}PUT /members/me/profile
/members/me/profileJWTUpdate the member profile fields (industry, experience, education, location, etc.).
Request Example
{
"current_industry": "Technology",
"years_experience": 8,
"education_level": "bachelors",
"location_country": "AU",
"location_state": "VIC"
}GET /members/me/traits
/members/me/traitsJWTReturns the member trait vector with category-level summaries and confidence levels. Individual trait weights are not exposed.
Query Parameters
| Name | Type | Description |
|---|---|---|
version | integer | Specific version number, or latest if omitted |
Response
{
"member_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"overall_confidence": 0.78,
"last_updated": "2026-03-09T14:00:00Z",
"traits": [
{
"trait_name": "pressure_response",
"score": 0.72,
"confidence": 0.81,
"lower_bound": 0.65,
"upper_bound": 0.79
}
],
"categorical_traits": [
{
"trait_name": "conflict_style",
"primary": "collaborative",
"distribution": [
{
"value": "collaborative",
"probability": 0.65
},
{
"value": "compromising",
"probability": 0.25
}
],
"confidence": 0.74
}
]
}GET /members/me/matches
/members/me/matchesJWTList matches for the member. Returns quality tier labels only - no numeric scores. Requires engagement level 4 (Deployed). Cursor-paginated.
Query Parameters
| Name | Type | Description |
|---|---|---|
status | string | Filter by match status |
limit | integer | Page size (max 100) |
cursor | string | Pagination cursor |
Response
{
"data": [
{
"id": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
"job_title": "Senior Platform Engineer",
"org_name": "TechCorp AU",
"match_tier": "strong",
"confidence_level": "high",
"status": "pending_review",
"created_at": "2026-03-08T09:00:00Z"
}
],
"pagination": {
"next_cursor": "eyJzIjoiMC44MiIsImlkIjoiZDRl...",
"has_more": true,
"total_count": 12
}
}GET /members/me/consent
/members/me/consentJWTReturns current consent records and history for the member.
POST /members/me/consent
/members/me/consentJWTGrant or withdraw consent for a specific data processing purpose. Append-only - creates a new record.
Request Example
{
"consent_type": "assessment_data",
"granted": true,
"version": "1.0"
}POST /members/me/consent/withdraw-all
/members/me/consent/withdraw-allJWTWithdraw all consent and trigger the account deletion process.
DELETE /members/me
/members/meJWTRequest account deletion (GDPR right to erasure). Marks the account for deletion; actual data removal is processed by a background job following retention policies.
GET /members/me/earnings
/members/me/earningsJWTReturns x402 earnings from real transaction data: total earned, pending, transaction count, and unique organisations.
GET /members/me/legibility
/members/me/legibilityJWTReturns the legibility score and breakdown. Legibility measures how complete, confident, and queryable an identity is - it determines the earning multiplier for x402 transactions.
POST /members/me/data-export
/members/me/data-exportJWTQueue a data export request for the member. Returns 202 Accepted.
GET /members/me/archetype
/members/me/archetypeJWTComputes the archetype assignment from the latest trait vector using weighted cosine similarity against the 12 archetype templates.