Get User Profile

Retrieve the user’s complete profile including auto-generated bio, category profiles, and insights

GET /profile

cURL

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

import requests

url = "https://api.memchat.io/profile"
headers = {
    "X-API-Key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
profile = response.json()

const response = await fetch('https://api.memchat.io/profile', {
  method: 'GET',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
  },
});

const profile = await response.json();

Response

{
  "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

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

import requests

url = "https://api.memchat.io/profile"
headers = {
    "X-API-Key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
profile = response.json()

const response = await fetch('https://api.memchat.io/profile', {
  method: 'GET',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
  },
});

const profile = await response.json();

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

Show Bio Properties

summary · string

Concise biographical summary (150-200 words)

generated_at · string

ISO 8601 timestamp when bio was generated

confidence · number

Confidence score for bio accuracy (0.0-1.0)

word_count · number

Number of words in the bio

categories · object

Category-specific profile information

Show Category Profiles

identity · object

Identity and personal information profile

career · object

Professional and career-related profile

interests · object

Hobbies and interests profile

relationships · object

Social connections and relationships profile

health · object

Health and wellness profile

finance · object

Financial information profile

learning · object

Education and learning profile

travel · object

Travel experiences and preferences profile

productivity · object

Work habits and productivity profile

private · object

Private memories profile summary

insights · array

AI-derived insights about the user

Show Insight Properties

insight_id · string

Unique identifier for the insight

title · string

Brief title of the insight

description · string

Detailed description of the insight

category · string

Primary category the insight relates to

confidence · number

Confidence score for the insight (0.0-1.0)

generated_at · string

When the insight was generated

memory_count · number

Number of memories supporting this insight

traits · array

Personality traits and characteristics

Show Trait Properties

trait · string

Name of the personality trait

strength · number

Strength of the trait (0.0-1.0)

evidence_count · number

Number of memories supporting this trait

category · string

Primary category where trait is observed

stats · object

Statistics about the user’s memories

Show Statistics

total_memories · number

Total number of stored memories

by_category · object

Memory count by category

by_type · object

Memory count by type (semantic/episodic)

date_range · object

First and last memory dates

avg_importance · number

Average importance score across memories

top_participants · array

Most frequently mentioned people

top_locations · array

Most frequently mentioned locations

privacy_settings · object

User’s privacy configuration for profile

Show Privacy Settings

bio_public · boolean

Whether bio can be shared publicly

categories_public · array

Which category profiles are public

insights_enabled · boolean

Whether AI insights are enabled

trait_analysis_enabled · boolean

Whether personality trait analysis is enabled

last_updated · string

ISO 8601 timestamp when profile was last updated

Response

{
  "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.