Get Task Status

Use this API to check the status of a video parsing task and retrieve the list of video IDs associated with that task.

Prerequisites

• You’re familiar with the concepts described on the Platform overview page.
• You have a valid memories.ai API key.

Host URL

• https://api.memories.ai

Endpoint

GET /serve/api/v1/get_video_ids_by_task_id

---

Request Example

import requests

headers = {"Authorization": "<API_KEY>"}

params = {
    "task_id": "4b2d85ea-8b61-4689-96c3-75d907140242_84f9d9b4b6e5940b67e67e2d17ef1f97",
    "unique_id": "1"
}

response = requests.get(
    "https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id",
    headers=headers,
    params=params
)

print("Status:", response.status_code)
try:
    print("Task Status Response:", response.json())
except Exception:
    print("Response Text:", response.text)

Request Parameters

Name	Location	Type	Required	Description
Authorization	header	string	Yes	Your API key for authentication
task_id	query	string	Yes	The unique task ID returned when you created the parsing task
unique_id	query	string	No	Correlation identifier; defaults to "default" if not set

---

Response Example

{
  "code": "0000",
  "msg": "success",
  "data": {
    "taskId": "4b2d85ea-8b61-4689-96c3-75d907140242_84f9d9b4b6e5940b67e67e2d17ef1f97",
    "video_ids": [
      "PI-603068775285264430",
      "PI-603068775285264431"
    ]
  },
  "failed": false,
  "success": true
}

Response Structure

Name	Type	Description
code	string	Response status code
msg	string	Human-readable status message
data	object	Response data container
» taskId	string	The unique task ID
» video_ids	array	List of video IDs generated by the uploading task
failed	boolean	Indicates whether the request failed
success	boolean	Indicates whether the request succeeded

Explanation of task_id and Responses

• The "video_ids" field in the response indicates the progress of the task:
  • If the value is an empty list [], the system is still downloading the video(s) from the platform.
  • If the field contains one or more video IDs (e.g., "PI-603068775285264430"), the video(s) have been successfully downloaded and are now in the indexing process.