Get Current User

Get profile information for the authenticated user. Use this to verify authentication is working and check sync status. Returns: external user id, email, name, account creation date, sync completion status (is_sync_complete), and active status. The is_sync_complete flag indicates whether the user’s network data is ready for queries.

GET /v2/user/me

Get Current User

cURL

curl --request GET \
  --url https://api.village.ai/v2/user/me \
  --header 'Authorization: Bearer <token>'

200

{
  "data": {
    "id": "user_abc123",
    "email": "[e-mail]",
    "name": "John Doe",
    "created_at": "2024-01-01T00:00:00.000Z",
    "is_sync_complete": true,
    "is_active": true
  },
  "metadata": {
    "request_id": "<string>"
  }
}

Authorizations

Authorization · string · header · required

• Personal: Get your API token
• Verified apps: Create a user token
• Testing: use demo_token_global

Response

200

application/json

User information retrieved successfully

data · object · required

Current authenticated user information

Show child attributes

metadata · object · required

Show child attributes