Skip to main content

Users API

Manage user profiles, ratings, and reputation.

Endpoints​

Get Current User​

GET /users/me

Response

{
  "id": "user123",
  "evmAddress": "0x...",
  "solanaAddress": "...",
  "displayName": "João",
  "avatar": "https://...",
  "bio": "Delivery expert",
  "globalXP": 1250,
  "reputation": 92,
  "totalEarned": "5670000000",
  "totalSpent": "1230000000",
  "createdAt": "2025-01-01T00:00:00Z",
  "lastActiveAt": "2025-12-01T00:00:00Z"
}

Update Profile​

PATCH /users/me

Request Body

{
  "displayName": "João Silva",
  "bio": "Expert courier",
  "avatar": "https://..."
}

Get User Stats​

GET /users/:id/stats

Response

{
  "missionsPosted": 45,
  "missionsCompleted": 234,
  "averageRating": 4.8,
  "ratingCount": 189,
  "disputesWon": 2,
  "disputesLost": 0
}

Get User Ratings​

GET /users/:id/ratings

Response

[
  {
    "id": "rating123",
    "missionId": "mission123",
    "rater": { "id": "...", "displayName": "..." },
    "ratee": { "id": "...", "displayName": "..." },
    "score": 5,
    "comment": "Excellent service!",
    "createdAt": "2025-12-01T00:00:00Z"
  }
]

Submit Rating​

POST /ratings

Request Body

{
  "missionId": "mission123",
  "score": 5,
  "comment": "Great work!"
}

POST /users/me/link-solana

Request Body

{
  "solanaAddress": "...",
  "signature": "..."
}