Skip to main content
GET
/
profile
curl -X GET 'https://api.memchat.io/profile' \
  -H 'X-API-Key: YOUR_API_KEY'

{
  "user_id": "user_123abc",
  "bio": {
    "summary": "A passionate software engineer and AI enthusiast based in San Francisco. Currently working at a tech startup focused on machine learning applications in healthcare. Enjoys hiking, reading about emerging technologies, and spending time with family. Has a strong interest in sustainable technology and frequently travels for both work and leisure. Values continuous learning and meaningful relationships.",
    "generated_at": "2024-01-15T16:30:00Z",
    "confidence": 0.92,
    "word_count": 67
  },
  "categories": {
    "career": {
      "title": "Software Engineer & AI Enthusiast",
      "summary": "Works at a tech startup focused on ML applications in healthcare",
      "key_skills": ["Python", "Machine Learning", "Healthcare Technology"],
      "memory_count": 45,
      "last_updated": "2024-01-15T14:20:00Z"
    },
    "interests": {
      "primary_interests": ["Technology", "Hiking", "Reading", "Sustainability"],
      "emerging_interests": ["Medical Imaging", "Green Technology"],
      "memory_count": 32,
      "last_updated": "2024-01-15T13:45:00Z"
    },
    "relationships": {
      "close_connections": ["Sarah Johnson", "Dr. Martinez", "Alex Chen"],
      "professional_network": ["Team members", "Healthcare professionals"],
      "memory_count": 28,
      "last_updated": "2024-01-15T15:10:00Z"
    }
  },
  "insights": [
    {
      "insight_id": "insight_456def",
      "title": "Strong Learning Orientation",
      "description": "Shows consistent pattern of seeking new knowledge and skills, particularly in AI and healthcare domains",
      "category": "learning",
      "confidence": 0.88,
      "generated_at": "2024-01-15T16:00:00Z",
      "memory_count": 12
    }
  ],
  "traits": [
    {
      "trait": "Curiosity",
      "strength": 0.91,
      "evidence_count": 15,
      "category": "learning"
    },
    {
      "trait": "Collaboration",
      "strength": 0.85,
      "evidence_count": 23,
      "category": "relationships"
    }
  ],
  "stats": {
    "total_memories": 142,
    "by_category": {
      "career": 45,
      "interests": 32,
      "relationships": 28,
      "learning": 25,
      "travel": 12
    },
    "by_type": {
      "semantic": 89,
      "episodic": 53
    },
    "date_range": {
      "first_memory": "2023-11-01T09:00:00Z",
      "last_memory": "2024-01-15T16:30:00Z"
    },
    "avg_importance": 0.72,
    "top_participants": ["Sarah Johnson", "Dr. Martinez", "Alex Chen"],
    "top_locations": ["San Francisco", "Stanford Medical Center", "Office"]
  },
  "privacy_settings": {
    "bio_public": false,
    "categories_public": ["interests", "career"],
    "insights_enabled": true,
    "trait_analysis_enabled": true
  },
  "last_updated": "2024-01-15T16:30:00Z"
}
Retrieves the user’s comprehensive profile, which includes an auto-generated bio, category-specific profiles, derived insights, and statistics about their stored memories. 
curl -X GET 'https://api.memchat.io/profile' \
  -H 'X-API-Key: YOUR_API_KEY'

​
Query Parameters

​
include
string
Comma-separated list of sections to include. Options: bio, categories, insights, stats, traits Default: bio,categories,stats
​
category
string
Filter to specific category profile. One of: identity, career, interests, relationships, health, finance, learning, travel, productivity, private
​
refresh
boolean
default:"false"
Whether to regenerate the profile from latest memories (may take longer)

​
Response

​
user_id
string
Unique identifier of the user
​
bio
object
Auto-generated biographical summary
​
categories
object
Category-specific profile information
​
insights
array
AI-derived insights about the user
​
traits
array
Personality traits and characteristics
​
stats
object
Statistics about the user’s memories
​
privacy_settings
object
User’s privacy configuration for profile
​
last_updated
string
ISO 8601 timestamp when profile was last updated
{
  "user_id": "user_123abc",
  "bio": {
    "summary": "A passionate software engineer and AI enthusiast based in San Francisco. Currently working at a tech startup focused on machine learning applications in healthcare. Enjoys hiking, reading about emerging technologies, and spending time with family. Has a strong interest in sustainable technology and frequently travels for both work and leisure. Values continuous learning and meaningful relationships.",
    "generated_at": "2024-01-15T16:30:00Z",
    "confidence": 0.92,
    "word_count": 67
  },
  "categories": {
    "career": {
      "title": "Software Engineer & AI Enthusiast",
      "summary": "Works at a tech startup focused on ML applications in healthcare",
      "key_skills": ["Python", "Machine Learning", "Healthcare Technology"],
      "memory_count": 45,
      "last_updated": "2024-01-15T14:20:00Z"
    },
    "interests": {
      "primary_interests": ["Technology", "Hiking", "Reading", "Sustainability"],
      "emerging_interests": ["Medical Imaging", "Green Technology"],
      "memory_count": 32,
      "last_updated": "2024-01-15T13:45:00Z"
    },
    "relationships": {
      "close_connections": ["Sarah Johnson", "Dr. Martinez", "Alex Chen"],
      "professional_network": ["Team members", "Healthcare professionals"],
      "memory_count": 28,
      "last_updated": "2024-01-15T15:10:00Z"
    }
  },
  "insights": [
    {
      "insight_id": "insight_456def",
      "title": "Strong Learning Orientation",
      "description": "Shows consistent pattern of seeking new knowledge and skills, particularly in AI and healthcare domains",
      "category": "learning",
      "confidence": 0.88,
      "generated_at": "2024-01-15T16:00:00Z",
      "memory_count": 12
    }
  ],
  "traits": [
    {
      "trait": "Curiosity",
      "strength": 0.91,
      "evidence_count": 15,
      "category": "learning"
    },
    {
      "trait": "Collaboration",
      "strength": 0.85,
      "evidence_count": 23,
      "category": "relationships"
    }
  ],
  "stats": {
    "total_memories": 142,
    "by_category": {
      "career": 45,
      "interests": 32,
      "relationships": 28,
      "learning": 25,
      "travel": 12
    },
    "by_type": {
      "semantic": 89,
      "episodic": 53
    },
    "date_range": {
      "first_memory": "2023-11-01T09:00:00Z",
      "last_memory": "2024-01-15T16:30:00Z"
    },
    "avg_importance": 0.72,
    "top_participants": ["Sarah Johnson", "Dr. Martinez", "Alex Chen"],
    "top_locations": ["San Francisco", "Stanford Medical Center", "Office"]
  },
  "privacy_settings": {
    "bio_public": false,
    "categories_public": ["interests", "career"],
    "insights_enabled": true,
    "trait_analysis_enabled": true
  },
  "last_updated": "2024-01-15T16:30:00Z"
}

​
Error Responses

​
401
object
Unauthorized access
{
  "error": "Invalid or expired token",
  "code": "UNAUTHORIZED"
}
​
404
object
Profile not found (new user)
{
  "error": "Profile not yet generated",
  "code": "PROFILE_NOT_FOUND",
  "suggestion": "Store some memories first to generate a profile"
}
​
429
object
Rate limit exceeded for profile generation
{
  "error": "Too many profile requests",
  "code": "RATE_LIMIT_EXCEEDED",
  "retry_after": 60
}

​
Profile Generation

Profiles are automatically generated when:
  • User has stored at least 5 memories
  • At least 24 hours have passed since last generation
  • User explicitly requests refresh with refresh=true
Generation typically takes 5-15 seconds depending on memory count.

​
Privacy Controls

Use the Update Profile Privacy endpoint to modify which parts of the profile are public or can be shared with integrations.