---
title: "Get user profile"
method: POST
path: "/v4/profile"
tags: ["Profile"]
---

# Get user profile

`POST /v4/profile`

Get user profile with optional search results

## Request body

- object
  - `q` string — Optional search query to include search results in the response
  - `containerTag` string, required — Tag to filter the profile by. This can be an ID for your user, a project ID, or any other identifier you wish to use to filter memories.
  - `threshold` number — Threshold for search results. Only results with a score above this threshold will be included.

## Response `200`

User profile with optional search results

- object
  - `profile` object, required
    - `static` string[], required — Static profile information that remains relevant long-term
    - `dynamic` string[], required — Dynamic profile information (recent memories)
  - `searchResults` object — Search results if a search query was provided
    - `results` unknown[], required — Search results for the provided query
      - unknown
    - `total` number, required — Total number of search results
    - `timing` number, required — Search timing in milliseconds

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized
- `402` — Search query limit reached (when search query is provided)
- `500` — Server error

## Changes

- **2026-01-09** `57367558035f` — 1 info
  - the request property `threshold` became optional
- **2026-01-09** `b1d58ccf9003` — 1 breaking
  - added the new required request property `threshold`

[Change history](https://skmtc.dev/supermemoryai/apis/supermemory-api/changes/v4/profile/post.md)

---

[API](https://skmtc.dev/supermemoryai/apis/supermemory-api.md) · [All operations](https://skmtc.dev/supermemoryai/apis/supermemory-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supermemoryai/supermemory-api/revisions/17d9426ee757/schema)