Skip to main content
GET
/
serve
/
api
/
v1
/
list_unique_ids
List Unique IDs
curl --request GET \
  --url https://api.memories.ai/serve/api/v1/list_unique_ids \
  --header 'Authorization: <api-key>'
{
  "code": "0000",
  "msg": "success",
  "data": {
    "unique_ids": [
      "default",
      "holiday_2025",
      "project_alpha"
    ]
  },
  "success": true,
  "failed": false
}

Documentation Index

Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Prerequisites

  • You’re familiar with the concepts described on the Platform overview.
  • You have created a memories.ai API key.
  • You have uploaded at least one video under any unique_id — a folder is auto-created on first upload and shows up here.

​
Host URL

https://api.memories.ai

​
Endpoint

GET /serve/api/v1/list_unique_ids 
/serve/api/v1/list_unique_ids

​
Authentication

Pass your API key in the Authorization request header. The account is resolved from the API key — no query or body parameters are required. 
Authorization: <API_KEY>

​
Request Example

import requests

url = "https://api.memories.ai/serve/api/v1/list_unique_ids"
headers = {"Authorization": "<API_KEY>"}

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

​
Query Parameters

None.

​
Notes & Limits

  • Rate limiting: The endpoint is protected by a per-account rate limit. Exceeding the limit returns an error indicating the request has exceeded the limit.
  • Scope of results: Returns every folder that has been created under the authenticated account, including the implicit default scope once it has been used. Deduplicated by name.
  • Empty account: If no uploads have ever been made under this account, data.unique_ids is an empty array.

​
Response Example

{
    "code": "0000",
    "msg": "success",
    "data": {
        "unique_ids": [
            "default",
            "holiday_2025",
            "project_alpha"
        ]
    },
    "success": true,
    "failed": false
}

​
Response Fields

​
code
string
Business status code. 0000 indicates success.
​
msg
string
Human-readable status message.
​
data.unique_ids
array
Array of unique_id scope names belonging to the authenticated account. Each entry can be used as the unique_id parameter for other endpoints (upload, list_videos, get_metadata, search, chat, etc.). Deduplicated and never contains empty strings.

Authorizations

​
Authorization
string
header
required

Response

200 - application/json

Successful response

​
code
string
Example:

"0000"

​
msg
string
Example:

"success"

​
data
object
​
success
boolean
Example:

true

​
failed
boolean
Example:

false