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

# 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.
  - `filters` union — Optional metadata filters to apply to profile results and search results. Supports complex AND/OR queries with multiple conditions.
    - object
      - `OR` union[], required — Array of OR filter expressions
        - union — A logical filter expression that can combine conditions using AND/OR operations. Supports up to 5 levels of nesting.
          - object — A single filter condition based on metadata, numeric values, array contents, or string matching
            - `filterType` 'metadata' | 'numeric' | 'array_contains' | 'string_contains'
            - `key` string, required
            - `negate` union
              - …
            - `ignoreCase` union
              - …
            - `numericOperator` '>' | '<' | '>=' | '<=' | '='
            - `value` string, required
          - object
            - `OR` union[], required — OR: Array of conditions or nested expressions
              - …
          - object
            - `AND` union[], required — AND: Array of conditions or nested expressions
              - …
    - object
      - `AND` union[], required — Array of AND filter expressions
        - union — A logical filter expression that can combine conditions using AND/OR operations. Supports up to 5 levels of nesting.
          - object — A single filter condition based on metadata, numeric values, array contents, or string matching
            - `filterType` 'metadata' | 'numeric' | 'array_contains' | 'string_contains'
            - `key` string, required
            - `negate` union
              - …
            - `ignoreCase` union
              - …
            - `numericOperator` '>' | '<' | '>=' | '<=' | '='
            - `value` string, required
          - object
            - `OR` union[], required — OR: Array of conditions or nested expressions
              - …
          - object
            - `AND` union[], required — AND: Array of conditions or nested expressions
              - …

## 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-04-06** `cb825424a780` — 2 info
  - api tag `Profiles` added
  - api tag `Profile` removed
- **2026-03-15** `b40318167017` — 1 breaking
  - request body became required
- **2026-02-24** `062b5e0b84ca` — 1 info
  - added the new optional request property `filters`
- **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/f979eba02e97/schema)